ToolBox MCP Server

ToolBox MCP服务器

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

中文文档

贡献

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

工具规格

特性

工具

查看完整的工具规格和详细文档： 工具.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验证：自动检查参数架构合规性
3. 测试生成：根据功能描述生成测试用例
4. 安全审查：静态代码分析和依赖性检查
5. 持续集成：通过GitHub Actions自动部署

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

发展

安装依赖项：

npm install

构建服务器：

npm run build

对于自动重建的开发：

npm run watch

市场提交

*Claude桌面无缝集成自动化工具包*

安装

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

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %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通信，调试MCP服务器可能具有挑战性。以下是一些方法：

🚧 免责声明

敏感数据

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

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

法律责任⚠️

• ⚠️ 该工具根据MIT许可证“按原样”提供，不作任何保证
• ⚠️ 开发商不对直接/间接损害负责
• ⚠️ 用户承担容器配置不当的所有风险
• ⚠️ 严禁任何非法或破坏性使用
• ⚠️ 这个 许可证 完整条款

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

node --inspect=9229 build/index.js

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

1. MCP检查员： 利用 MCP检查员，一个可通过访问的专用调试工具 inspector npm脚本：

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