duckdb-mcp-server

🚀 DuckDB MCP 服务器

DuckDB MCP 服务器是一个模型上下文协议（MCP）服务器实现，它能让 AI 助手（如Claude）借助 DuckDB 开展强大的数据分析工作，为数据处理和分析带来了新的便利。

🚀 快速开始

DuckDB MCP 服务器借助 模型上下文协议 (MCP)，将 AI 助手与 DuckDB 这一高性能分析数据库相连接。这使得 AI 模型可以直接查询各类数据源（如 CSV、Parquet、JSON 等）中的数据，还能从云存储（S3 等）访问数据，无需复杂设置，并且可以使用强大的 SQL 执行数据分析，进而在上下文和理解中生成数据见解。

✨ 主要特性

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

📦 安装指南

使用 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 路径/to/database.db [options]

必要参数：

• --db-path - DuckDB 数据库文件路径。

可选参数：

• --host - 指定绑定地址（默认：::1）。
• --port - 指定端口（默认：8080）。

📄 许可证

此项目在 MIT License 下开源。

🙏 贡献

欢迎贡献！请随意提交 Pull Request。