MCP服务器与MotherDuck数据库的集成使用指南

1. 项目介绍

MotherDuck's DuckDB MCP Server 是一个开源项目，它实现了一个MCP服务器，能够与DuckDB和MotherDuck数据库进行交互，为AI助手和IDE提供SQL分析能力。该服务器支持本地DuckDB数据库和基于云的MotherDuck数据库的混合执行，并能够访问存储在亚马逊S3或其他云存储中的数据。

2. 项目快速启动

以下是快速启动MCP服务器的步骤：

首先，确保你已经安装了uv工具。可以使用以下命令进行安装：

pip install uv
# 或者
brew install uv

然后，根据你使用的客户端工具（如Cursor、VS Code或Claude Desktop）进行相应的配置。

Cursor配置示例：

打开Cursor设置，添加新的全局MCP服务器配置。这将打开一个mcp.json文件，你需要添加以下配置：

{
  "mcpServers": {
    "mcp-server-motherduck": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        "md:",
        "--motherduck-token",
        "<YOUR_MOTHERDUCK_TOKEN_HERE>"
      ]
    }
  }
}

VS Code配置示例：

在VS Code的用户设置（JSON）文件中添加以下配置：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "motherduck_token",
        "description": "MotherDuck Token",
        "password": true
      }
    ],
    "servers": {
      "motherduck": {
        "command": "uvx",
        "args": [
          "mcp-server-motherduck",
          "--db-path",
          "md:",
          "--motherduck-token",
          "${input:motherduck_token}"
        ]
      }
    }
  }
}

Claude Desktop配置示例：

在Claude Desktop的配置文件claude_desktop_config.json中添加以下配置：

{
  "mcpServers": {
    "mcp-server-motherduck": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        "md:",
        "--motherduck-token",
        "<YOUR_MOTHERDUCK_TOKEN_HERE>"
      ]
    }
  }
}

请确保将<YOUR_MOTHERDUCK_TOKEN_HERE>替换为你的MotherDuck令牌。

3. 应用案例和最佳实践

以下是一些使用MCP服务器的应用案例和最佳实践：

• 创建新数据库和表：使用MCP服务器提供的prompt和tool，可以轻松创建新的数据库和表。
• 查询本地CSV文件：可以通过MCP服务器直接查询本地的CSV文件，无需额外的数据导入步骤。
• 联合本地和云端数据：MCP服务器可以同时查询本地DuckDB数据库和云端MotherDuck数据库中的数据，实现数据的联合分析。
• 分析云端存储数据：对于存储在亚马逊S3等云存储的数据，可以通过MCP服务器直接进行SQL分析。

4. 典型生态项目

在MotherDuck生态中，有几个典型的项目可以帮助你更好地使用MCP服务器：

• MotherDuck：核心数据库服务，提供了高性能的云原生SQL数据库。
• DuckDB：一个嵌入式的分析数据管理系统，可以在本地执行复杂的SQL查询。
• Cursor：一个AI驱动的IDE，可以与MCP服务器配合使用，提供更加智能的开发体验。

通过上述介绍，你可以开始探索如何将MCP服务器与MotherDuck数据库集成，以实现高效的SQL数据分析。