MCP Services - mcp-server-duckdb

简介

MCP-Server-DuckDB 允许大语言模型通过 Model Context Protocol 与 DuckDB 数据库交互，支持查询执行、表格创建和数据分析。

安装与配置

快速安装（推荐）

通过 Smithery 安装到 Claude Desktop：

npx -y @smithery/cli install mcp-server-duckdb --client claude

手动配置 Claude Desktop

编辑配置文件：

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

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

主要功能

服务器提供以下工具：

工具	描述	参数
`read-query`	执行 SELECT 查询	`query` (字符串)
`write-query`	执行修改数据的查询	`query` (字符串)
`create-table`	创建新表	`query` (字符串)
`list-tables`	列出所有表	无
`describe-table`	查看表结构	`table_name` (字符串)

配置选项

db-path: DuckDB 数据库文件路径（必需）
--readonly: 以只读模式运行，禁用写操作（可选）

调试

使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uv --directory ~/mcp-server-duckdb run mcp-server-duckdb

安全说明

在生产环境中，建议使用 --readonly 模式以防止意外数据修改。

完整文档请访问 Smithery