mcp-toolbox

环境要求

• Node.js 与 npx（使用 npx 方式运行 Toolbox 时）
• Docker（使用容器镜像方式运行时）
• 一个 MCP 兼容客户端，如 Gemini CLI、Claude Code、Codex、Google Antigravity
• 可访问的数据库及对应连接信息（连接所需环境变量见官方 Prebuilt Tools Reference）

安装与启动步骤

1. 1配置MCP客户端

   在客户端的 mcp.json 或 claude_desktop_config.json 中加入该配置，即可获得 PostgreSQL 预置工具；换数据库改 --prebuilt 值。

   {
     "mcpServers": {
       "toolbox-postgres": {
         "command": "npx",
         "args": [
           "-y",
           "@toolbox-sdk/server",
           "--prebuilt=postgres",
           "--stdio"
         ]
       }
     }
   }

   复制

2. 2npx快速运行

   自定义工具场景下需先按官方 Resources 文档编写 tools.yaml，再用 npx 拉起服务器加载该配置。此法便于尝鲜，性能非最优。

   npx @toolbox-sdk/server --config tools.yaml

   复制

3. 3下载二进制

   以 Linux AMD64 为例，从 releases 页确认版本号后下载并赋予可执行权限，其他系统架构替换下载地址中的平台路径。

   export VERSION=1.11.0
   curl -L -o toolbox https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/linux/amd64/toolbox
   chmod +x toolbox

   复制

4. 4启动服务器

   用二进制方式启动服务器并指定配置文件；Toolbox 默认开启配置动态重载，可加 --disable-reload 关闭。

   ./toolbox --config "tools.yaml"

   复制

5. 5用Docker运行

   拉取对应版本的容器镜像，把本地 tools.yaml 挂载进容器，映射 5000 端口后启动服务器。

   export VERSION=0.24.0
   docker run -p 5000:5000 \
   -v $(pwd)/tools.yaml:/app/tools.yaml \
   us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION \
   --config "/app/tools.yaml"

   复制

6. 6安装Gemini扩展

   可选：全局安装 Gemini CLI，再安装 mcp-toolbox 扩展，即可用自然语言调用自定义工具。

   npm install -g @google/gemini-cli
   gemini extensions install https://github.com/gemini-cli-extensions/mcp-toolbox
   gemini

   复制

关键配置

如何确认成功

服务器启动无报错，且 MCP 客户端中能列出该 Toolbox 提供的数据库工具并成功执行一次查询。

常见问题

注意事项

• 环境变量的具体名称与配置方式见官方 Prebuilt Tools Reference 文档，README 未逐一列出。
• 容器运行时 -v 把本地 tools.yaml 挂载到容器内 /app/tools.yaml，路径需按实际目录调整。
• npx 方式仅适合快速试用，生产环境建议改用二进制或容器镜像。
• 预置工具也可通过 Google Antigravity MCP Store 一键安装。