ToolBox MCP Server

An AI-powered automation tool development platform, providing:

Modular Architecture - Tool hot-reloading via the src/tools directory AI Assistance - AI engine for natural language to tool template conversion Enterprise-Grade Capabilities - Integration of production environment services such as MongoDB/Redis/SSH Real-time Updates - Zero-downtime deployment via 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

中文文档

Contributing

Contributing Guidelines (English) Contributing Guidelines (中文)

Tool Specifications

Features

Tools

View the complete tool specifications and detailed documentation: TOOL.md

Resources

Resources are generated dynamically as a result of tool execution. For example, the create_note tool creates a note resource that can be accessed via its URI.

Workflow Tool

The workflow_tool is a powerful tool for orchestrating complex workflows by chaining together multiple tools. It supports:

• Serial and Parallel Execution: Execute tools in a sequential or parallel manner.
• Transaction Management: Manage transactions with compensation mechanisms for error handling.
• Detailed Reporting: Generate detailed reports on workflow execution, including the status, execution time, and results of each step.
• Customizable Output: Specify an output file to save the workflow execution report.

Prompts

• summarize_notes: Generates summaries of the notes created using the create_note tool.

Development Guide

Adding New Tools

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

Detailed Development Process

1. Template Creation: Create a new tool file in the src/tools/ directory
2. AI Verification: Automatically check the parameter Schema compliance
3. Test Generation: Generate test cases based on the function description
4. Security Review: Static code analysis and dependency checking
5. Continuous Integration: Automated deployment via GitHub Actions

View the complete development guide: prompt.md Refer to existing implementations: Tool Examples

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Marketplace Submission

A Seamless Integrated Automation Toolkit for Claude Desktop

Installation

To integrate with the Claude Desktop application, add the following server configuration to:

• 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": []
}

Core Values

Enterprise-Grade Automation Leveraging package.json configuration, providing:

• Global CLI tool installation (tbx command)
• Workflow scheduling engine
• Multi-platform support (Windows/macOS)
• Hybrid cloud deployment capabilities (MongoDB/Redis/SSH)

Developer-Friendly

• Strongly-typed TypeScript implementation
• Real-time debugging support (–inspect flag)
• VSCode debugging configuration template
• Hot-reloading mechanism:

  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
  

  Implemented by calling buildReload_tool:
  • Zero-downtime updates
  • Automatic dependency tree parsing
  • Version compatibility check
  • Sandbox environment testing

Debugging

Debugging MCP servers can be challenging due to their stdio communication. Here are a few approaches:

Disclaimers

Sensitive Data

DO NOT CONFIGURE CONTAINERS WITH SENSITIVE DATA. This includes API keys, database passwords, etc.

Any sensitive data exchanged with the LLM is inherently compromised, unless the LLM is running on your local machine.

Legal Liability

• The tool is provided “as-is” under MIT License without warranties
• Developer not liable for direct/indirect damages
• Users bear all risks from improper container configurations
• Any illegal or destructive usage is strictly prohibited
• See LICENSE for full terms

1. Node.js Inspector: Launch the server with the --inspect=9229 flag:

node --inspect=9229 build/index.js

Then, connect to the server using Chrome DevTools by navigating to chrome://inspect.

2. MCP Inspector: Utilize the MCP Inspector, a dedicated debugging tool accessible via the inspector npm script:

3. VSCode Debugging

To debug with VSCode, create a .vscode/launch.json file with the following configuration:

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

Then, launch the server with the --inspect=9229 flag and attach the VSCode debugger.