ToolBox MCP 服务器

GitHub 发布

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

🧩 模块化架构 - 通过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

中文詳細

贡献

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

工具规格

Related MCP server: CbetaMCP

特征

工具

查看完整的工具规格和详细文档： 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

详细开发流程

模板创建：在src/tools/目录中创建一个新的工具文件
AI验证：自动检查参数Schema合规性
测试生成：根据功能描述生成测试用例
安全审查：静态代码分析和依赖性检查
持续集成：通过 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 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",
    "SSEPORT": "8080" // Optional: If set, the server will use SSE transport on this port. Otherwise, it defaults to Stdio transport.
  },
  "disabled": false,
  "autoApprove": []
}

核心价值观

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

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

🔧开发者友好

强类型 TypeScript 实现
实时调试支持（--inspect 标志）
VSCode 调试配置模板

热重载机制：

graph LR
  A[Code Modification] --> B[buildReload_tool]
  B --> C[Automatic Compilation]
  C --> D[Security Verification]
  D --> E[Tool Reloading]
  style B fill:#4CAF50,stroke:#333

通过调用buildReload_tool实现：

零停机更新
自动依赖树解析
版本兼容性检查
沙盒环境测试

调试

由于 MCP 服务器使用 stdio 通信，调试起来可能比较困难。以下是一些方法：

🚧 免责声明

敏感数据

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

除非 LLM 在您的本地机器上运行，否则与 LLM 交换的任何敏感数据本质上都会受到损害。

法律责任⚠️

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

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

node --inspect=9229 build/index.js

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

**MCP 检查器：**利用MCP 检查器，这是一个可通过inspector npm 脚本访问的专用调试工具：
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 调试器。