Toolbox

🚀 工具箱：AI驱动自动化工具开发平台

ToolBox 是一个基于 MIT 许可证开源的 AI 驱动自动化工具开发平台。它借助 package.json 配置，提供了一系列强大功能，能有效解决自动化工具开发中的诸多问题，为企业和开发者带来了高效、便捷的开发体验。

🚀 快速开始

在项目根目录下创建 package.json，添加以下内容：

{
  "version": "1.0.0",
  "name": "toolbox_demo",
  "description": "ToolBox 示例项目",
  "scripts": {
    "start": "node build/index.js"
  },
  "tbx": {
    "servers": [
      {
        "id": "mcp_example_1",
        "type": "MCP_SERVER",
        "config": "examples/example_config.json"
      }
    ]
  }
}

然后运行以下命令完成初始化：

npm install tbx --save-dev
tbx init

✨ 主要特性

1. 企业级自动化

• 具备强大的模块化架构，可灵活扩展工具链。
• 支持实时调试（使用 --inspect 标志）。
• 提供 VSCode 调试配置模板。
• 拥有热重载机制：

graph LR
  A[代码修改] --> B[buildReload_tool]
  B --> C[自动编译]
  C --> D[安全验证]
  D --> E[工具热重载]

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

2. 开发者友好性

• 使用强类型 TypeScript 实现。
• 支持通过 Chrome DevTools 和 VSCode 进行调试。
• 热重载机制：

graph LR
  A[代码修改] --> B[buildReload_tool]
  B --> C[自动编译]
  C --> D[安全验证]
  D --> E[工具热重载]

可实现零停机时间更新和版本兼容性检查。

📦 安装指南

在项目根目录下创建 package.json，添加如下内容：

{
  "version": "1.0.0",
  "name": "toolbox_demo",
  "description": "ToolBox 示例项目",
  "scripts": {
    "start": "node build/index.js"
  },
  "tbx": {
    "servers": [
      {
        "id": "mcp_example_1",
        "type": "MCP_SERVER",
        "config": "examples/example_config.json"
      }
    ]
  }
}

接着运行以下命令完成初始化：

npm install tbx --save-dev
tbx init

📚 详细文档

核心价值

企业级自动化能力

• 全局 CLI 工具安装：可通过 tbx 命令快速访问工具箱功能。
• 工作流调度引擎：支持复杂的任务编排和依赖管理。
• 多平台支持：能在 Windows 和 macOS 上无缝运行。
• 混合云部署：集成了 MongoDB、Redis 和 SSH 远程连接能力。

开发者友好性

• 强类型 TypeScript：提供严格类型检查和代码补全。
• 实时调试支持：通过 --inspect 标志启用调试模式。
• VSCode 调试配置：自动生成调试配置文件。
• 热重载机制：实现零停机时间更新和版本兼容性检查。

诊断与调试

1. Node.js 调试

启动服务器时添加 --inspect=9229 标志：

node --inspect=9229 build/index.js

然后在 Chrome 中打开 chrome://inspect 进行调试。

2. MCP 调试工具

使用 MCP Inspector，通过以下命令启动：

npm run inspector

3. VSCode 调试配置

在项目根目录下创建 .vscode/launch.json 文件，添加如下配置：

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

注意事项

敏感数据

请勿在容器中配置敏感信息（如 API 密钥、数据库密码等）。任何与大语言模型 (LLM) 的交互都会默认 compromising 敏感数据，除非 LLM 在本地运行。

法律责任

• 警告：本工具按“原样”提供，不附带任何形式的担保。
• 开发者不对任何直接或间接损害承担责任。
• 用户需自行承担配置和使用过程中的一切风险。
• 请勿用于任何非法用途。

📄 许可证

本项目基于 MIT 许可证开源。