MCP Gearbox CLI
Setup high-quality MCP servers faster.
CLI tool to quickly download, configure, and deploy Model Context Protocol (MCP) servers for AI agents ā cross-platform support for Windows, macOS, and Linux.
Documentation
For detailed usage instructions, please visit our documentation.
š¤ Overview
MCP Gearbox is a powerful Python CLI dev-tools package that provides an interactive way to discover, download, and configure Model Context Protocol (MCP) servers from the official ecosystem. This AI-powered tool automatically configures model-context-protocol servers for your preferred AI coding agent with cross-platform support and intelligent configuration management.
ā” Installation
Using uv (recommended)
uv tool install mcp-gearbox --from git+https://github.com/rohitsoni007/mcp-gearbox-cli
To upgrade mcp-cli run:
uv tool install mcp-gearbox --force --from git+https://github.com/rohitsoni007/mcp-gearbox-cli
Using uvx (one-time execution)
uvx --from git+https://github.com/rohitsoni007/mcp-gearbox-cli mcp-cli
Using uv & pip
uv tool install mcp-gearbox
Using npm
npm install -g mcp-gearbox
Using pip
pip install mcp-gearbox
Development installation
git clone https://github.com/rohitsoni007/mcp-gearbox-cli
cd mcp-gearbox-cli
uv sync
š¤ Supported AI Agents
| Agent | Support | Notes |
|---|---|---|
| GitHub Copilot | ā | |
| Continue | ā | |
| Kiro | ā | |
| Cursor | ā | |
| Claude Code | ā | |
| Gemini CLI | ā | |
| Qoder | ā ļø | Qoder does not support project-level MCP configuration |
| Copilot CLI | ā | Copilot CLI does not support project-level MCP configuration |
| LM Studio | ā | LM Studio does not need project-level MCP configuration |
| Google Antigravity | ā | Google Antigravity does not support project-level MCP configuration |
š§ MCP CLI Reference
The mcp command supports the following options:
Commands
| Command | Description |
|---|---|
init | Initialize MCP configuration (supports both project-specific and global configuration) |
list | List configured MCP servers or all available servers |
rm | Remove MCP servers from configuration |
check | Check which AI agents are installed on your system |
mcp init Arguments & Options
| Argument/Option | Type | Description |
|---|---|---|
<directory> | Argument | Directory to initialize MCP configuration (use . for current directory, omit for global configuration) |
--servers, -s | Option | MCP server names to add directly. Use multiple times (-s git -s filesystem) or space-separated (-s "git filesystem") - optional |
--agent, -a | Option | AI agent to configure: copilot, copilot-cli, continue, kiro, cursor, claude, gemini, qoder, or lmstudio |
--json, -j | Option | Output in JSON format without banner or UI |
--pretty | Option | Pretty print JSON output (default: false) |
mcp list Arguments & Options
| Argument/Option | Type | Description |
|---|---|---|
--agent, -a | Option | AI agent to list servers for: copilot, copilot-cli, continue, kiro, cursor, claude, gemini, qoder, lmstudio, or antigravity |
--project, -p | Option | Project path (use '.' for current directory, omit for global configuration) |
--servers, -s | Option | List all available MCP servers instead of configured ones |
--json, -j | Option | Output in JSON format without banner or UI |
--pretty | Option | Pretty print JSON output when listing available servers (default: false) |
mcp rm Arguments & Options
| Argument/Option | Type | Description |
|---|---|---|
<servers> | Argument | MCP server names to remove (e.g., 'git', 'filesystem') - optional |
--all, -A | Option | Remove all MCP servers |
--agent, -a | Option | AI agent to configure: copilot, copilot-cli, continue, kiro, cursor, claude, gemini, qoder, lmstudio, or antigravity |
--project, -p | Option | Project path (use '.' for current directory, omit for global configuration) |
--force, -f | Option | Skip confirmation prompts |
--json, -j | Option | Output in JSON format without banner or UI |
--pretty | Option | Pretty print JSON output (default: false) |
mcp check Arguments & Options
| Argument/Option | Type | Description |
|---|---|---|
--agent, -a | Option | Specific agent to check: copilot, copilot-cli, continue, kiro, cursor, claude, gemini, qoder, lmstudio, or antigravity |
--json, -j | Option | Output in JSON format without banner or UI |
--pretty | Option | Pretty print JSON output (default: false) |
š§ Usage Examples
# Check which AI agents are installed on your system
mcp check
# Interactive Model Context Protocol server selection (choose from available AI agents)
# Configure MCP globally
mcp init
# Configure MCP globally for GitHub Copilot AI agent
mcp init -a copilot
# Configure MCP globally for Copilot CLI
mcp init -a copilot-cli
# Configure MCP globally for Continue AI
mcp init -a continue
# Configure MCP globally for Kiro AI agent
mcp init -a kiro
# Configure MCP globally for Cursor AI agent
mcp init -a cursor
# Configure MCP globally for Qoder AI agent
mcp init -a qoder
# Configure MCP globally for Claude Code
mcp init -a claude
# Configure MCP globally for Gemini CLI
mcp init -a gemini
# Configure MCP globally for LM Studio AI agent
mcp init -a lmstudio
# Configure MCP globally for Google Antigravity
mcp init -a antigravity
# Add specific MCP servers directly without interactive selection
# Method 1: Space-separated in quotes
mcp init -a copilot --servers "git filesystem"
# Method 2: Multiple option flags
mcp init -a copilot -s git -s filesystem
# Add specific servers for Continue AI with JSON output (compact)
mcp init -a continue --servers "git filesystem" --json
# Add specific servers for Continue AI with pretty JSON output
mcp init -a continue --servers "git filesystem" --json --pretty
# Add servers to current directory project
mcp init . -a copilot --servers "git filesystem"
# Add servers to new project directory
mcp init my-project -a continue -s git -s filesystem
# Initialize MCP in current directory
mcp init .
# Initialize MCP in a new project directory
mcp init my-project
# Initialize MCP for GitHub Copilot AI agent in new project directory
mcp init my-project -a copilot
# Initialize MCP for Continue AI agent in new project directory
mcp init my-project -a continue
# Initialize MCP for Kiro AI agent in new project directory
mcp init my-project -a kiro
# Initialize MCP for Cursor AI agent in new project directory
mcp init my-project -a cursor
# Initialize MCP for Claude Code in new project directory
mcp init my-project -a claude
# Initialize MCP for Gemini CLI in new project directory
mcp init my-project -a gemini
# Initialize MCP for Google Antigravity in new project directory
mcp init my-project -a antigravity
mcp list Examples
# Interactive MCP server listing (choose from available AI agents)
# List servers from global configuration
mcp list
# List servers for specific agent from global configuration
mcp list -a copilot
mcp list -a copilot-cli
mcp list -a continue
mcp list -a kiro
mcp list -a cursor
mcp list -a claude
mcp list -a gemini
mcp list -a qoder
mcp list -a lmstudio
mcp list -a antigravity
# List servers from current directory configuration
mcp list -p .
# List servers from specific project directory
mcp list -p my-project
# List servers for specific agent from project
mcp list -a copilot -p my-project
# Output in JSON format (useful for scripting and automation)
mcp list -a continue --json
mcp list -a continue -j
# JSON output for project-specific configuration
mcp list -a continue -p my-project --json
mcp list -a continue -p my-project -j
# List all available MCP servers (interactive display)
mcp list --servers
mcp list -s
# List all available MCP servers with JSON output (pretty printed)
mcp list --servers --json
# List all available MCP servers with pretty JSON output
mcp list --servers --json --pretty
mcp list -s -j --pretty
mcp rm Examples
# Interactive MCP server removal (choose from configured servers)
# Remove servers from global configuration
mcp rm
# Interactive removal for specific agent
mcp rm -a copilot
mcp rm -a copilot-cli
# Remove specific MCP servers from global configuration
mcp rm git filesystem
# Remove specific servers for GitHub Copilot AI agent
mcp rm git filesystem -a copilot
# Remove specific servers for Copilot CLI
mcp rm git filesystem -a copilot-cli
# Remove specific servers for Continue AI
mcp rm git filesystem -a continue
# Remove specific servers for Kiro AI agent
mcp rm git filesystem -a kiro
# Remove specific servers for Cursor AI agent
mcp rm git filesystem -a cursor
# Remove specific servers for Claude Code
mcp rm git filesystem -a claude
# Remove specific servers for Gemini CLI
mcp rm git filesystem -a gemini
# Remove specific servers for Google Antigravity
mcp rm git filesystem -a antigravity
# Remove all MCP servers from global configuration
mcp rm --all
# Remove all servers for specific agent
mcp rm --all -a copilot
mcp rm --all -a copilot-cli
# Interactive removal from current directory configuration
mcp rm -p .
# Interactive removal from specific project directory
mcp rm -p my-project
# Remove specific servers from current directory configuration
mcp rm git filesystem -p .
# Remove specific servers from specific project directory
mcp rm git filesystem -p my-project
# Remove all servers from project directory
mcp rm --all -p my-project
# Remove servers with force (skip confirmations)
mcp rm git filesystem --force
# Remove all servers with force
mcp rm --all --force
# Output in JSON format (useful for scripting and automation)
mcp rm git filesystem -a continue --json
mcp rm git filesystem -a continue -j
# Output in pretty JSON format (human-readable)
mcp rm git filesystem -a continue --json --pretty
# Remove all servers with JSON output
mcp rm --all -a continue --json
mcp rm --all -a continue -j
# Remove all servers with pretty JSON output
mcp rm --all -a continue --json --pretty
# Remove servers from project with JSON output
mcp rm git filesystem -p my-project -a continue --json
mcp rm git filesystem -p my-project -a continue -j
mcp check Examples
# Check all AI agents installation status
mcp check
# Check specific agent installation status
mcp check -a copilot
mcp check -a copilot-cli
mcp check -a continue
mcp check -a kiro
mcp check -a cursor
mcp check -a claude
mcp check -a gemini
mcp check -a qoder
mcp check -a lmstudio
mcp check -a antigravity
# Output in JSON format (useful for scripting and automation)
mcp check --json
mcp check -j
# Output in pretty JSON format (human-readable)
mcp check --json --pretty
mcp check -j --pretty
# Check specific agent with JSON output
mcp check -a continue --json
mcp check -a continue -j
# Check specific agent with pretty JSON output
mcp check -a continue --json --pretty
General Examples
# Show version
mcp --version
mcp -v
š Features
- šÆ Interactive AI agent selection and configuration
- š Interactive MCP server selection with intelligent filtering
- š§ Automatic model-context-protocol configuration file generation
- š Cross-platform Python dev-tools support (Windows, Linux, macOS)
- š Automatic AI agent configuration path detection
- š System-wide AI agent installation detection and status checking
- š ļø CLI-based workflow for seamless developer experience
šÆ Experimental Goals
- Common MCP server for all AI agents - Unified configuration and management across different AI platforms
- Future edit feature - Planned functionality to modify and update existing MCP configurations
Development
Project Structure
mcp-gearbox-cli/
āāā src/mcp_cli/ # Main CLI package
ā āāā __init__.py # Core CLI functionality
āāā templates/ # Configuration templates
āāā scripts/ # Build and deployment scripts
š§ Requirements
- Linux/macOS/Windows
- uv for package management
- Python 3.11+
- Git
If you encounter issues with an agent, please open an issue so we can refine the integration.
š„ Maintainers
- Rohit Soni (@rohitsoni007)
š¬ Support
For support, please open a GitHub issue. We welcome bug reports, feature requests, and questions about using MCP CLI.
š Acknowledgements
This project is based on the data from Model Context Protocol Servers and Github MCP Registry.
Keywords
MCP model-context-protocol ai cli dev-tools python artificial-intelligence developer-tools command-line automation ai-agents github-copilot continue configuration-management cross-platform
š License
This project is licensed under the terms of the MIT open source license. Please refer to the LICENSE file for the full terms.