MCP Tool Documentation

Overview

The MCP Tool is a command-line utility for managing Model Context Protocol (MCP) servers. It provides a unified interface for running, configuring, and integrating various MCP servers with tools like Claude and Cursor.

Key Features

Core Functionality

- List available MCP servers and server groups
- Run MCP servers individually or as groups
- Display detailed information about servers
- Generate comprehensive documentation 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:

   git clone https://github.com/your-username/mcptool.git

   cd mcptool

   

2. Make the main script executable:

   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:

   alias mcpt='/path/to/mcptool.sh'

   

Usage

The main script (mcptool.sh) serves as the unified command center for all functionality.

Basic Commands

MCP Tool v1.2.0 - Manage MCP Servers
Usage: ./bin/mcptool.sh <command> [target] [options]
Commands:

  list                   List servers and groups

  run <target> [--bg]    Run a server or group. Groups run in separate terminals.

                         Use --background or --bg to run in detached background mode.

  add <server> <opts>    Add server definition to a required backend/file.

                         Target Options (required): --claude | --cursor [--global] | --json <file> | <file>

  info <target> [-v]     Show info for a server or group (use -v for group details)

  json <target>          Output server/group JSON definition

  docs                   Show documentation for all servers

  interactive            Launch interactive TUI menu (requires 'dialog')

  autoloader             Generate shell autocompletion script

  help <cmd>             Show detailed help for a command
Common Options:

  --servers-file=<path>  Specify servers file (default: /Users/estiens/code/mcptool/config/servers.json)

  --groups-file=<path>   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 <command>' 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=<path>: 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:

   ./mcptool.sh autoloader

   

2. Add the following line to your .zshrc file:

   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 <server|group>: Run a specific server or group
- mcpt info <server|group>: Get information about a server or group
- mcpt json <server|group>: Get JSON definition for a server or group
- mcpt add <server> --claude|--cursor [--global]|--json <file>|<file>: Add server definition
- mcpt docs: Generate comprehensive documentation
- mcpt interactive: Launch interactive mode

Interactive Mode

The interactive mode provides a user-friendly menu interface for managing MCP servers. Launch it with:

./mcptool.sh interactive

The menu allows you to:
- Run a server
- Get server information
- Run a server group
- Get group information
- View documentation
- Add server definitions using the 'add' command (outside interactive mode)
- Exit the application

Claude and Cursor Integration

MCP Tool makes it easy to add server definitions to both Claude and Cursor MCP:

Claude Integration

```bash