鸭子数据库MCP服务器

鸭子数据库MCP服务器是一个实现，它使像Claude这样的AI助手能够通过模型上下文协议（MCP）与鸭子数据库进行交互，以实现强大的数据分析能力。

🌟 鸭子数据库MCP服务器是什么？

鸭子数据库MCP服务器通过模型上下文协议（MCP）将AI助手连接到鸭子数据库——一个高性能分析数据库。这使得AI模型可以：

• 直接从各种数据源（如CSV、Parquet、JSON等）查询数据。
• 在没有复杂设置的情况下访问云存储（S3等）中的数据。
• 使用SQL执行复杂的数据分析。
• 根据适当的上下文和理解生成数据洞察。

🚀 主要特性

• SQL查询工具：使用鸭子数据库的强大语法执行任何SQL查询。
• 多种数据源：直接从以下位置查询：
  • 本地文件（CSV、Parquet、JSON等）
  • S3桶和其他云存储
  • SQLite数据库
  • 鸭子数据库支持的所有其他数据源
• 自动连接管理：自动创建和处理数据库文件连接。
• 智能凭证处理：无缝的AWS/S3凭证管理。
• 文档资源：内置的鸭子数据库SQL和数据导入参考，供AI助手使用。

📋 要求

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

💻 安装

使用pip

pip install duckdb-mcp-server

从源码安装

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

🔧 配置

命令行选项

duckdb-mcp-server --db-path path/to/database.db [options]

必需参数：

• --db-path - 鸭子数据库文件的路径（如果不存在则会创建）

可选参数：

• --readonly - 以只读模式运行（如果数据库不存在则会报错）
• --s3-region - AWS S3区域（默认：使用AWS_DEFAULT_REGION环境变量）
• --s3-profile - S3凭证的AWS配置文件（默认：使用AWS_PROFILE或'default'）
• --creds-from-env - 使用来自环境变量的AWS凭证

🔌 与Claude Desktop一起设置

1. 从claude.ai/download安装Claude Desktop。

2. 编辑Claude Desktop的配置文件：

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   Windows: %APPDATA%/Claude/claude_desktop_config.json

3. 添加鸭子数据库MCP服务器配置：

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

📊 示例用法

配置完成后，您可以要求您的AI助手使用鸭子数据库分析数据：

"加载sales.csv文件并显示按收入排名前五的产品"

AI将生成并执行相应的SQL：

-- 加载并查询CSV数据
SELECT 
    product_name,
    SUM(quantity * price) AS revenue
FROM read_csv('sales.csv')
GROUP BY product_name
ORDER BY revenue DESC
LIMIT 5;

使用S3数据

直接从S3桶查询数据：

"分析我们S3中分析数据中的每日用户注册情况"

AI将生成适当的SQL来查询S3：

SELECT 
    date_trunc('day', signup_timestamp) AS day,
    COUNT(*) AS num_signups
FROM read_parquet('s3://my-analytics-bucket/signups/*.parquet')
GROUP BY day
ORDER BY day DESC;

🌩️ 云存储认证

鸭子数据库MCP服务器按照以下顺序处理AWS认证：

1. 显式凭证（如果启用了--creds-from-env）
2. 命名配置文件凭证（通过--s3-profile）
3. 默认凭证链（环境、共享凭证文件等）

🛠️ 开发

# 克隆仓库
git clone https://github.com/yourusername/duckdb-mcp-server.git
cd duckdb-mcp-server

# 设置虚拟环境
python -m venv venv
source venv/bin/activate  # 在Windows上：venv\Scripts\activate

# 以开发模式安装
pip install -e ".[dev]"

# 运行测试
pytest

📜 许可证

该项目根据MIT许可证发布 - 查看LICENSE文件了解详情。

🙏 贡献

欢迎贡献！请随时提交拉取请求。