ToolBox MCP Server

一个基于AI的自动化工具开发平台，提供以下功能：

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

graph LR
    A[Developer] -->|Create| B(Tool Template)
    B --> C{AI Verification}
    C -->|Pass| D[Automatic Loading]
    C -->|Fail| E[Human Review]
    D --> F[API Exposure]
    F --> G[Client Invocation]
    style C fill:#4CAF50,stroke:#333

中文文档

贡献

贡献指南（英文）
贡献指南（中文）

工具规范

特性

工具

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

资源

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

工作流工具

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

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

提示

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

开发指南

添加新工具

graph TD
    A[Create Tool Template] --> B{AI Automatic Verification}
    B -->|Schema Validation| C[Generate Test Cases]
    B -->|Risk Exists| D[Human Review]
    C --> E[Unit Testing]
    D -->|Approve| E
    E --> F[Security Scanning]
    F --> G[Build Integration]
    G --> H[Version Release]
    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桌面应用的无缝集成自动化工具箱

安装

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

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

// Cline MCP server configuration file
{
  "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 标志)
• 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 连接到服务器。

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

2. 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 调试器。