umentation for all servers - Output server definitions in JSON format ### Advanced Features - **Claude Integration**: Easily add server definitions to Claude MCP - **Cursor Integration**: Add server definitions to Cursor MCP config - **Autoloader for .zshrc**: Integrate with your shell environment with autocomplete - **Interactive Mode**: Select and manage servers through a user-friendly menu - **Configuration Wizard**: Set up environment variables required by servers - **Improved Error Handling**: Better feedback when issues occur - **Enhanced Help System**: Detailed usage information for each command ## Installation 1. Clone or download the script files to your preferred location: ```bash git clone https://github.com/your-username/mcptool.git cd mcptool ``` 2. Make the main script executable: ```bash chmod +x mcptool.sh ``` 3. Ensure you have the required dependencies: - `jq`: JSON processor (required for parsing server configurations) - `dialog`: Optional, used for interactive mode 4. (Optional) Create an alias for easier access: ```bash alias mcpt='/path/to/mcptool.sh' ``` ## Usage The main script (`mcptool.sh`) serves as the unified command center for all functionality. ### Basic Commands ```bash MCP Tool v1.2.0 - Manage MCP Servers Usage: ./bin/mcptool.sh [target] [options] Commands: list List servers and groups run [--bg] Run a server or group. Groups run in separate terminals. Use --background or --bg to run in detached background mode. add Add server definition to a required backend/file. Target Options (required): --claude | --cursor [--global] | --json | info [-v] Show info for a server or group (use -v for group details) json Output server/group JSON definition docs Show documentation for all servers interactive Launch interactive TUI menu (requires 'dialog') autoloader Generate shell autocompletion script help Show detailed help for a command Common Options: --servers-file= Specify servers file (default: /Users/estiens/code/mcptool/config/servers.json) --groups-file= Specify groups file (default: /Users/estiens/code/mcptool/config/groups.json) -v, --verbose Show detailed output (used with 'info group') --background, --bg Run server/group in background (used with 'run') Note: The tool supports both JSON and YAML formats for configuration files Run './bin/mcptool.sh help ' for more details on a specific command. ``` ### Common Options - `-v, --verbose`: Show detailed output (especially useful with `info` command) - `--project`: Use project-level scope for Claude/Cursor integration (default) - `--global`: Use global/user-level scope for Claude/Cursor integration - `--json-file=`: Specify custom JSON file location ### Environment Variables - `MCP_CONFIG_FILE`: Alternative path to the JSON configuration file ## Shell Integration with Autoloader The autoloader feature creates a script that can be sourced in your `.zshrc` file to provide convenient shell functions and tab completion for MCP server commands. 1. Generate the autoloader file: ```bash ./mcptool.sh autoloader ``` 2. Add the following line to your `.zshrc` file: ```bash source ~/.mcp_autoloader.zsh ``` 3. After reloading your shell, you can use these commands with tab completion: - `mcpt list`: List all available servers and groups - `mcpt run `: Run a specific server or group - `mcpt info `: Get information about a server or group - `mcpt json `: Get JSON definition for a server or group - `mcpt add --claude|--cursor [--global]|--json |`: Add server definition - `mcpt docs`: Generate comprehensive documentation - `mcpt interactive`: Launch interactive mode ## Interactive Mode The interactive mode provides a user-fr

#bash-script

MCP Tool Documentation