MCP服务器使用与配置指南

1. 项目目录结构及介绍

开源项目mcp-server-motherduck的目录结构如下：

mcp-server-motherduck/
├── .github/            # GitHub工作流程和钩子配置
│   └── workflows/
├── src/                # 源代码目录
│   └── mcp_server_motherduck/
├── .gitignore          # Git忽略文件配置
├── .python-version     # 项目Python版本要求
├── LICENSE             # 项目许可证文件
├── README.md           # 项目说明文件
├── makefile            # Makefile构建脚本
├── pyproject.toml      # Python项目配置文件
└── uv.lock             # UV进程锁文件

项目文件说明：

• .github/workflows/：包含项目的自动化工作流程，如CI/CD流程。
• src/mcp_server_motherduck/：包含MCP服务器的核心源代码。
• .gitignore：定义Git应该忽略的文件和目录。
• .python-version：指定项目所需的Python版本。
• LICENSE：项目的开源许可证，本项目采用MIT许可证。
• README.md：项目的主要说明文件，包含项目的介绍、功能、使用方法和配置说明。
• makefile：用于构建项目的Makefile文件。
• pyproject.toml：Python项目的配置文件，包含项目元数据和依赖。
• uv.lock：UV进程的锁文件，用于确保同一时间只有一个实例在运行。

2. 项目的启动文件介绍

mcp-server-motherduck项目的启动主要通过命令行工具uvx来执行。在项目目录中，通常通过以下命令启动服务器：

uvx mcp-server-motherduck

如果需要指定数据库路径，可以使用--db-path参数：

uvx mcp-server-motherduck --db-path /path/to/your/local.db

对于连接到MotherDuck数据库，需要使用--motherduck-token参数来提供访问令牌：

uvx mcp-server-motherduck --db-path md: --motherduck-token <your_motherduck_token>

3. 项目的配置文件介绍

mcp-server-motherduck项目的配置文件主要在.vscode/mcp.json或者在用户的设置文件中定义。以下是一个配置文件的示例：

{
  "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}"
      ]
    }
  }
}

在这个配置文件中：

• inputs部分定义了一个名为motherduck_token的输入，用于输入MotherDuck的访问令牌。
• servers部分定义了一个名为motherduck的服务器配置，其中包含了启动MCP服务器的命令和参数，包括数据库路径和MotherDuck令牌。

确保替换${input:motherduck_token}为实际的令牌值，以正确配置服务器。