ToolBox MCP 服务器

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

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

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 是一个强大的工具，用于通过链接多个工具来编排复杂的工作流程。 它支持：

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

提示词 (Prompts)

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

开发指南

添加新工具

graph TD
    A[创建工具模板] --> B{AI 自动验证}
    B -->|Schema 验证| 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 验证：自动检查参数 Schema 合规性
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",
  },
  "disabled": false,
  "autoApprove": []
}

核心价值

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

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

🔧 开发者友好

• 强类型 TypeScript 实现
• 实时调试支持 (--inspect flag)
• VSCode 调试配置模板
• 热重载机制：

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

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

调试

由于 MCP 服务器的 stdio 通信，调试 MCP 服务器可能具有挑战性。 以下是一些方法：

🚧 免责声明

敏感数据

请勿配置包含敏感数据的容器。 这包括 API 密钥、数据库密码等。

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

法律责任 ⚠️

• ⚠️ 该工具按“原样”提供，并根据 MIT 许可证提供，不提供任何保证
• ⚠️ 开发者不对直接/间接损害负责
• ⚠️ 用户承担因不正确的容器配置而产生的所有风险
• ⚠️ 严禁任何非法或破坏性使用
• ⚠️ 有关完整条款，请参见 LICENSE

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

node --inspect=9229 build/index.js

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

2. MCP 检查器： 利用 MCP 检查器，这是一个可通过 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 调试器。