ToolBox MCP Server

一个由AI驱动的自动化工具开发平台，提供：

🧩 模块化架构 - 通过 src/tools 目录实现工具热重载 🤖 AI 辅助 - 将自然语言转换为工具模板的AI引擎 🚀 企业级能力 - 集成生产环境服务如 MongoDB/Redis/SSH 🔄 实时更新 - 通过 buildReload_tool 实现零停机部署

<a href="https://glama.ai/mcp/servers/@xiaoguomeiyitian/ToolBox"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=3793033206,401630556&fm=3081&app=3081&f=PNG?w=760&h=200" alt="ToolBox Server MCP server" /> </a>

graph LR
    A[开发者] -->|创建| B(工具模板)
    B --> C{AI验证}
    C -->|通过| D[自动加载]
    C -->|失败| E[人工审核]
    D --> F[API暴露]
    F --> G[客户端调用]
    style C fill:#4CAF50,stroke:#333

中文文档

贡献指南

贡献指南 (英文) 贡献指南 (中文)

工具规范

特性

工具

查看完整的工具规范和详细文档：TOOL.md

资源

资源是作为工具执行的结果动态生成的。例如，create_note 工具创建了一个可以通过其URI访问的笔记资源。

工作流工具

workflow_tool 是一个强大的工具，用于通过串联多个工具来编排复杂的工作流。它支持：

• 串行和并行执行：以顺序或并行方式执行工具。
• 事务管理：通过补偿机制进行错误处理的事务管理。
• 详细报告：生成关于工作流执行的详细报告，包括每个步骤的状态、执行时间和结果。
• 可定制输出：指定输出文件以保存工作流执行报告。

提示

• summarize_notes：根据使用 create_note 工具创建的笔记生成摘要。

开发指南

添加新工具

graph TD
    A[创建工具模板] --> B{AI自动验证}
    B -->|模式验证| C[生成测试案例]
    B -->|存在风险| D[人工审核]
    C --> E[单元测试]
    D -->|批准| E
    E --> F[安全扫描]
    F --> G[构建集成]
    G --> H[版本发布]
    style A fill:#f9f,stroke:#333
    style H fill:#4CAF50,stroke:#333

详细的开发过程

1. 模板创建：在 src/tools/ 目录中创建一个新的工具文件
2. AI验证：自动检查参数模式合规性
3. 测试生成：基于函数描述生成测试案例
4. 安全审查：静态代码分析和依赖项检查
5. 持续集成：通过 GitHub Actions 自动部署

查看完整的开发指南：prompt.md 参考现有实现：工具示例

开发

安装依赖：

npm install

构建服务器：

npm run build

开发时自动重建：

npm run watch

市场提交

一款无缝集成的自动化工具包，适用于 Claude Desktop

安装

要与 Claude Desktop 应用程序集成，请将以下服务器配置添加到：

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

// Cline MCP 服务器配置文件
{
  "command": "node",
  "args": [
    "--inspect=9229",
    "/MCP/ToolBox/build/index.js"
  ],
  "env": {
    "MONGO_URI": "mongodb://user:password@host:port/db",
    "MONGO_INDEX_OPS": "true",
    "REDIS_URI": "redis://:password@host:port",
    "SSH_server1_URI": "username:password@host:port",
    "GEMINI_API_KEY":"GEMINI_API_KEY",
    "SSEPORT": "8080" // 可选：如果设置，则服务器将在该端口上使用 SSE 传输。否则，默认使用 Stdio 传输。
  },
  "disabled": false,
  "autoApprove": []
}

核心价值

🚀 企业级自动化 利用 package.json 配置，提供：

• 全局 CLI 工具安装（tbx 命令）
• 工作流调度引擎
• 多平台支持（Windows/macOS）
• 混合云部署能力（MongoDB/Redis/SSH）

🔧 开发者友好

• 强类型 TypeScript 实现
• 实时调试支持（--inspect 标志）
• VSCode 调试配置模板
• 热重载机制：

  graph LR
    A[代码修改] --> B[buildReload_tool]
    B --> C[自动编译]
    C --> D[安全验证]
    D --> E[工具重载]
    style B fill:#4CAF50,stroke:#333
  

  通过调用 buildReload_tool 实现：
  • 零停机更新
  • 自动依赖树解析
  • 版本兼容性检查
  • 沙箱环境测试

调试

由于 MCP 服务器的 stdio 通信，调试可能会很困难。这里有一些方法：

🚧 免责声明

敏感数据

不要在容器中配置敏感数据。这包括 API 密钥、数据库密码等。

与 LLM 交换的任何敏感数据本质上都是不安全的，除非 LLM 在您的本地机器上运行。

法律责任 ⚠️

• ⚠️ 工具按“现状”提供，MIT 许可证下无任何担保
• ⚠️ 开发者不对直接或间接损害负责
• ⚠️ 用户承担因不当容器配置带来的所有风险
• ⚠️ 严格禁止任何非法或破坏性的使用
• ⚠️ 查看 LICENSE 获取完整条款

1. Node.js Inspector：使用 --inspect=9229 标志启动服务器：

node --inspect=9229 build/index.js

然后，通过导航到 chrome://inspect 使用 Chrome DevTools 连接到服务器。

2. MCP Inspector：使用 MCP Inspector，这是一个通过 inspector npm 脚本访问的专用调试工具。

3. VSCode 调试

要在 VSCode 中调试，创建一个 .vscode/launch.json 文件，配置如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "attach",
            "name": "ToolBox",
            "address": "localhost",
            "port": 9229,
            "localRoot": "${workspaceFolder}"
        }
    ]
}

然后，使用 --inspect=9229 标志启动服务器，并附加 VSCode 调试器。