DuckDB MCP Server

基本能力

产品定位

DuckDB MCP Server 是一个连接 AI 助手与 DuckDB 数据库的中间件，旨在为 AI 提供高效的数据查询和分析能力。

核心功能

• SQL 查询工具：支持执行任何 DuckDB 支持的 SQL 查询。
• 多数据源支持：可直接查询本地文件（CSV、Parquet、JSON 等）、S3 存储桶、SQLite 数据库等。
• 自动连接管理：自动创建和管理数据库文件连接。
• 智能凭证处理：无缝管理 AWS/S3 凭证。
• 内置文档资源：为 AI 助手提供 DuckDB SQL 和数据导入的参考文档。

适用场景

• AI 助手需要执行复杂的数据分析任务时。
• 需要从多种数据源（包括云存储）快速查询数据时。
• 自动化数据分析和报告生成。

工具列表

• SQL Query Tool：执行 SQL 查询。
• Data Source Connectors：连接多种数据源。
• Credential Manager：管理 AWS/S3 凭证。

常见问题解答

• 如何配置 AWS 凭证？：可以通过环境变量、命名配置文件或默认凭证链进行配置。
• 是否支持只读模式？：支持，通过 --readonly 参数启用。

使用教程

使用依赖

• Python 3.10+
• MCP 兼容的客户端（如 Claude Desktop、Cursor、VS Code with Copilot 等）

安装教程

使用 pip 安装

pip install duckdb-mcp-server

从源码安装

git clone https://github.com/yourusername/duckdb-mcp-server.git
cd duckdb-mcp-server
pip install -e .

调试方式

启动服务

duckdb-mcp-server --db-path path/to/database.db

可选参数

• --readonly：只读模式。
• --s3-region：指定 S3 区域。
• --s3-profile：指定 AWS 凭证配置文件。
• --creds-from-env：使用环境变量中的 AWS 凭证。

配置 Claude Desktop

1. 编辑配置文件：
2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Windows: %APPDATA%/Claude/claude_desktop_config.json
4. 添加配置：

{
  "mcpServers": {
    "duckdb": {
      "command": "duckdb-mcp-server",
      "args": [
        "--db-path",
        "~/claude-duckdb/data.db"
      ]
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。