mcp-commander


Namemcp-commander JSON
Version 0.1.2 PyPI version JSON
download
home_pageNone
SummaryCross-platform command-line tool for managing MCP (Model Context Protocol) servers across editors
upload_time2025-08-13 20:26:27
maintainerNone
docs_urlNone
authorNone
requires_python>=3.12
licenseApache-2.0
keywords mcp model-context-protocol claude cursor vscode cli
VCS
bugtrack_url
requirements colorama pydantic typer rich pytest pytest-cov pytest-mock mypy black flake8 isort build twine
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <div align="center">
  <img src="logo.png" alt="MCP Commander Logo" width="200" height="200" />

  # MCP Commander

  A convenient command-line tool to manage MCP (Model Context Protocol) servers across different code editors.

  [![PyPI Version](https://img.shields.io/pypi/v/mcp-commander)](https://pypi.org/project/mcp-commander/)
  [![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
  [![Python](https://img.shields.io/badge/Python-3.12%2B-blue.svg)](https://python.org/)
  [![Code Style: Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
  [![Pytest](https://img.shields.io/badge/Pytest-8.4-red.svg)](https://pytest.org/)
  [![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)](#)
  [![Coverage](https://img.shields.io/badge/coverage-85%25-green.svg)](#)
  [![CLI Commands](https://img.shields.io/badge/CLI%20Commands-12-blue.svg)](#-commands)
  [![Type Checking](https://img.shields.io/badge/mypy-enabled-blue.svg)](https://mypy-lang.org/)

</div>

## 🚀 Features

### Core MCP Operations
- **Multi-Editor Support**: Manage MCP servers for Claude Code, Claude Desktop, Cursor, and VS Code
- **Flexible Server Management**: Add, remove, and list servers across all or specific editors
- **Status Monitoring**: Check configuration file status and server counts
- **Rich CLI Interface**: Colorized output with tables and status indicators

### Advanced Management
- **🔍 Auto-Discovery**: Automatically discover all MCP configurations on your system
- **🌍 Add-All Command**: Install servers to ALL discovered MCP configurations at once
- **📊 Status Dashboard**: Comprehensive status overview of all editor configurations
- **âš™ī¸ Configuration Validation**: Pydantic-based configuration validation and error handling

### Developer Experience
- **Type Safety**: Full type hints and mypy compatibility
- **Error Handling**: Detailed error messages with actionable guidance
- **Extensible**: Easy to add support for new editors and MCP clients
- **Testing**: Comprehensive test coverage with pytest

## đŸ“Ļ Installation

### Option 1: From PyPI (Recommended)
```bash
# Install globally
pip install mcp-commander

# Or using pipx for isolated installation
pipx install mcp-commander
```

### Option 2: From Git Repository
```bash
# Install directly from GitHub
pip install git+https://github.com/nmindz/mcp-commander.git

# Or clone and install
git clone https://github.com/nmindz/mcp-commander.git
cd mcp-commander
pip install .
```

### Option 3: Development Installation
```bash
git clone https://github.com/nmindz/mcp-commander.git
cd mcp-commander
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e .
```

### Option 4: Direct Execution (No Installation Required)
```bash
# Clone repository
git clone https://github.com/nmindz/mcp-commander.git
cd mcp-commander

# Install dependencies only
pip install -r requirements-dev.txt

# Method A: Using run.py script
python run.py --help
python run.py list

# Method B: Using shell wrapper
./mcp.sh --help
./mcp.sh discover

# Method C: Using Python module syntax (cleanest)
PYTHONPATH="src:$PYTHONPATH" python -m mcpcommander --help
PYTHONPATH="src:$PYTHONPATH" python -m mcpcommander status
```

### Requirements
- Python 3.12 or higher
- Works on macOS, Windows, and Linux

## 💡 Getting Help

### Contextual Examples
Use `--help --verbose` (or `--help -v`) to see practical examples for any command:
```bash
# Show detailed help with examples
mcp add --help --verbose
mcp add-editor --help --verbose
mcp status --help --verbose

# Regular help (without examples)
mcp add --help
```

### Configuration Examples
View all transport configuration examples:
```bash
# Show all transport examples
mcp examples

# Show examples with usage instructions
mcp examples --verbose
```

## đŸ’ģ Commands

### 🔍 Discovery and Status
```bash
# Discover all MCP configurations on your system
mcp discover

# Check status of all editor configurations
mcp status

# List available editors
mcp editors
```

### 📝 Server Management
```bash
# List all configured servers
mcp list

# List servers for a specific editor
mcp list claude-code

# Add server to specific editor
mcp add myserver "npx @modelcontextprotocol/server-filesystem /tmp" claude-code

# Add server to all configured editors
mcp add myserver "npx @modelcontextprotocol/server-filesystem /tmp"
```

### 🌍 Environment Variable Support
```bash
# Copy environment variables from current environment
export MCP_LOG_LEVEL=info
export GIT_SIGN_COMMITS=false
mcp add git-server "npx @cyanheads/git-mcp-server" --from-env=MCP_LOG_LEVEL,GIT_SIGN_COMMITS

# Set explicit environment variables
mcp add api-server "npx my-api-server" --env=DEBUG:true --env=API_KEY:secret123

# Combine both approaches
mcp add hybrid-server "npx server" --from-env=LOG_LEVEL --env=CUSTOM_VAR:custom_value

# Use with JSON configuration (merges environment variables)
mcp add json-server '{"command": "npx", "args": ["server"], "env": {"EXISTING": "value"}}' --env=NEW_VAR:added

# Global verbose mode via environment variable
export MCP_COMMANDER_VERBOSE=1
mcp list  # Will run in verbose mode automatically
```

#### Generated Configuration
When using environment variables, MCP Commander generates server configurations like this:
```json
{
  "mcpServers": {
    "git-mcp-server": {
      "command": "npx",
      "args": ["@cyanheads/git-mcp-server"],
      "env": {
        "MCP_LOG_LEVEL": "info",
        "GIT_SIGN_COMMITS": "false"
      }
    }
  }
}
```

### 🌍 NEW: Add to All Discovered Configurations
```bash
# Automatically discover and install to ALL MCP configurations
mcp add-all myserver "npx @modelcontextprotocol/server-filesystem /tmp"

# Works with JSON configurations too
mcp add-all myserver '{"command": "npx", "args": ["-y", "@modelcontextprotocol/server-memory"]}'
```

### đŸ—‘ī¸ Server Removal
```bash
# Remove server from all configured editors
mcp remove myserver

# Remove server from specific editor
mcp remove myserver cursor
```

### â„šī¸ Help and Version
```bash
# Show help
mcp --help
mcp help  # Same as above

# Show version
mcp version
```

## Configuration

MCP Commander automatically manages its configuration in platform-specific user directories:

- **Windows**: `%APPDATA%/mcpCommander/config.json`
- **macOS**: `~/Library/Application Support/mcpCommander/config.json`
- **Linux**: `~/.config/mcpCommander/config.json`

When you first run any command, mcpCommander will automatically:
1. Create the user config directory
2. Migrate any existing `config.json` from the repository
3. Create a default config if none exists

The configuration defines which editors are supported and where their configuration files are located:

```json
{
  "editors": {
    "claude-code": {
      "config_path": "~/.claude.json",
      "jsonpath": "mcpServers"
    },
    "claude-desktop": {
      "config_path": "~/Library/Application Support/Claude/claude_desktop_config.json",
      "jsonpath": "mcpServers"
    },
    "cursor": {
      "config_path": "~/.cursor/mcp.json",
      "jsonpath": "mcpServers"
    }
  }
}
```

### Adding New Editors

To add support for a new editor, simply add an entry to the `editors` object in `config.json`:

```json
{
  "editors": {
    "new-editor": {
      "config_path": "/path/to/editor/config.json",
      "jsonpath": "mcpServers"
    }
  }
}
```

The `jsonpath` field supports simple dot notation for nested JSON paths (e.g., `"config.mcpServers"`).

## File Structure

```
mcpCommander/
├── config.json          # Editor configuration
├── mcp_manager.py       # Main Python script
├── mcp                  # Shell wrapper script
└── README.md           # This file
```

## Examples

### Managing your JIRA MCP server

```bash
# Add JIRA server to all editors
mcp add jira-mcp "~/Projects/me/jira-mcp/server.py"

# List all configured servers
mcp list

# Remove from just Cursor
mcp remove jira-mcp cursor

# Check what's configured
mcp status
```

### Adding a server with complex configuration

```bash
mcp add filesystem '{"command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "~/Documents"]}'
```

## đŸ› ī¸ Development

### Local Development Setup
```bash
# Clone the repository
git clone https://github.com/nmindz/mcp-commander.git
cd mcp-commander

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install with development dependencies
pip install -e ".[dev]"

# Run tests
pytest tests/

# Run linting and formatting
black src/ tests/
flake8 src/ tests/
mypy src/
```

### Project Structure
```
mcp-commander/
├── src/mcpcommander/          # Main package
│   ├── core/                  # Core business logic
│   ├── cli/                   # Command-line interface
│   ├── utils/                 # Utilities and helpers
│   └── schemas/               # Pydantic schemas
├── tests/                     # Test suite
│   ├── unit/                  # Unit tests
│   ├── integration/           # Integration tests
│   └── e2e/                   # End-to-end tests
├── docs/                      # Documentation
└── scripts/                   # Automation scripts
```

### Requirements
- Python 3.12 or higher
- Cross-platform (macOS, Windows, Linux)
- Rich CLI output with colorized formatting

## 🆕 What's New in v2.0

### 🔍 **Auto-Discovery System**
- Automatically finds all MCP configurations on your system
- Supports Claude Code, Claude Desktop, Cursor, VS Code, and more
- Cross-platform detection (macOS, Windows, Linux)

### 🌍 **Add-All Command**
```bash
# One command to rule them all!
mcp add-all my-server "npx @modelcontextprotocol/server-filesystem /tmp"
```
- Discovers ALL MCP configurations automatically
- Installs server to every found configuration
- Detailed success/failure reporting with colors

### 📊 **Enhanced CLI Experience**
- Rich table formatting for server listings
- Colorized status indicators (âœ…âŒâš ī¸)
- Comprehensive error messages with actionable guidance
- Verbose logging options for debugging

### đŸ—ī¸ **Modern Architecture**
- Enterprise-grade error handling with custom exceptions
- Type safety with comprehensive type hints
- Extensive test coverage (85%+)
- Modern Python packaging with pyproject.toml

## 🔧 Troubleshooting

### Common Issues
- **Configuration not found**: Run `mcp discover` to see all available MCP configurations
- **Permission errors**: Ensure you have write access to editor configuration directories
- **JSON validation errors**: Use `mcp status` to check configuration file integrity
- **Server conflicts**: Use `mcp list` to see existing servers before adding new ones

### Debug Mode
```bash
# Enable verbose output for debugging
mcp add-all myserver "command" --verbose
mcp list --verbose
```

### Getting Help
```bash
# Comprehensive help for any command
mcp --help
mcp add-all --help
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "mcp-commander",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.12",
    "maintainer_email": "Evandro Camargo <evandro@camargo.uk>",
    "keywords": "mcp, model-context-protocol, claude, cursor, vscode, cli",
    "author": null,
    "author_email": "Evandro Camargo <evandro@camargo.uk>",
    "download_url": "https://files.pythonhosted.org/packages/0c/81/98ce58134b573503282612d4af9276a1a060252cc5d02d136c6e3616cdbc/mcp_commander-0.1.2.tar.gz",
    "platform": null,
    "description": "<div align=\"center\">\n  <img src=\"logo.png\" alt=\"MCP Commander Logo\" width=\"200\" height=\"200\" />\n\n  # MCP Commander\n\n  A convenient command-line tool to manage MCP (Model Context Protocol) servers across different code editors.\n\n  [![PyPI Version](https://img.shields.io/pypi/v/mcp-commander)](https://pypi.org/project/mcp-commander/)\n  [![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n  [![Python](https://img.shields.io/badge/Python-3.12%2B-blue.svg)](https://python.org/)\n  [![Code Style: Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n  [![Pytest](https://img.shields.io/badge/Pytest-8.4-red.svg)](https://pytest.org/)\n  [![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)](#)\n  [![Coverage](https://img.shields.io/badge/coverage-85%25-green.svg)](#)\n  [![CLI Commands](https://img.shields.io/badge/CLI%20Commands-12-blue.svg)](#-commands)\n  [![Type Checking](https://img.shields.io/badge/mypy-enabled-blue.svg)](https://mypy-lang.org/)\n\n</div>\n\n## \ud83d\ude80 Features\n\n### Core MCP Operations\n- **Multi-Editor Support**: Manage MCP servers for Claude Code, Claude Desktop, Cursor, and VS Code\n- **Flexible Server Management**: Add, remove, and list servers across all or specific editors\n- **Status Monitoring**: Check configuration file status and server counts\n- **Rich CLI Interface**: Colorized output with tables and status indicators\n\n### Advanced Management\n- **\ud83d\udd0d Auto-Discovery**: Automatically discover all MCP configurations on your system\n- **\ud83c\udf0d Add-All Command**: Install servers to ALL discovered MCP configurations at once\n- **\ud83d\udcca Status Dashboard**: Comprehensive status overview of all editor configurations\n- **\u2699\ufe0f Configuration Validation**: Pydantic-based configuration validation and error handling\n\n### Developer Experience\n- **Type Safety**: Full type hints and mypy compatibility\n- **Error Handling**: Detailed error messages with actionable guidance\n- **Extensible**: Easy to add support for new editors and MCP clients\n- **Testing**: Comprehensive test coverage with pytest\n\n## \ud83d\udce6 Installation\n\n### Option 1: From PyPI (Recommended)\n```bash\n# Install globally\npip install mcp-commander\n\n# Or using pipx for isolated installation\npipx install mcp-commander\n```\n\n### Option 2: From Git Repository\n```bash\n# Install directly from GitHub\npip install git+https://github.com/nmindz/mcp-commander.git\n\n# Or clone and install\ngit clone https://github.com/nmindz/mcp-commander.git\ncd mcp-commander\npip install .\n```\n\n### Option 3: Development Installation\n```bash\ngit clone https://github.com/nmindz/mcp-commander.git\ncd mcp-commander\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\npip install -e .\n```\n\n### Option 4: Direct Execution (No Installation Required)\n```bash\n# Clone repository\ngit clone https://github.com/nmindz/mcp-commander.git\ncd mcp-commander\n\n# Install dependencies only\npip install -r requirements-dev.txt\n\n# Method A: Using run.py script\npython run.py --help\npython run.py list\n\n# Method B: Using shell wrapper\n./mcp.sh --help\n./mcp.sh discover\n\n# Method C: Using Python module syntax (cleanest)\nPYTHONPATH=\"src:$PYTHONPATH\" python -m mcpcommander --help\nPYTHONPATH=\"src:$PYTHONPATH\" python -m mcpcommander status\n```\n\n### Requirements\n- Python 3.12 or higher\n- Works on macOS, Windows, and Linux\n\n## \ud83d\udca1 Getting Help\n\n### Contextual Examples\nUse `--help --verbose` (or `--help -v`) to see practical examples for any command:\n```bash\n# Show detailed help with examples\nmcp add --help --verbose\nmcp add-editor --help --verbose\nmcp status --help --verbose\n\n# Regular help (without examples)\nmcp add --help\n```\n\n### Configuration Examples\nView all transport configuration examples:\n```bash\n# Show all transport examples\nmcp examples\n\n# Show examples with usage instructions\nmcp examples --verbose\n```\n\n## \ud83d\udcbb Commands\n\n### \ud83d\udd0d Discovery and Status\n```bash\n# Discover all MCP configurations on your system\nmcp discover\n\n# Check status of all editor configurations\nmcp status\n\n# List available editors\nmcp editors\n```\n\n### \ud83d\udcdd Server Management\n```bash\n# List all configured servers\nmcp list\n\n# List servers for a specific editor\nmcp list claude-code\n\n# Add server to specific editor\nmcp add myserver \"npx @modelcontextprotocol/server-filesystem /tmp\" claude-code\n\n# Add server to all configured editors\nmcp add myserver \"npx @modelcontextprotocol/server-filesystem /tmp\"\n```\n\n### \ud83c\udf0d Environment Variable Support\n```bash\n# Copy environment variables from current environment\nexport MCP_LOG_LEVEL=info\nexport GIT_SIGN_COMMITS=false\nmcp add git-server \"npx @cyanheads/git-mcp-server\" --from-env=MCP_LOG_LEVEL,GIT_SIGN_COMMITS\n\n# Set explicit environment variables\nmcp add api-server \"npx my-api-server\" --env=DEBUG:true --env=API_KEY:secret123\n\n# Combine both approaches\nmcp add hybrid-server \"npx server\" --from-env=LOG_LEVEL --env=CUSTOM_VAR:custom_value\n\n# Use with JSON configuration (merges environment variables)\nmcp add json-server '{\"command\": \"npx\", \"args\": [\"server\"], \"env\": {\"EXISTING\": \"value\"}}' --env=NEW_VAR:added\n\n# Global verbose mode via environment variable\nexport MCP_COMMANDER_VERBOSE=1\nmcp list  # Will run in verbose mode automatically\n```\n\n#### Generated Configuration\nWhen using environment variables, MCP Commander generates server configurations like this:\n```json\n{\n  \"mcpServers\": {\n    \"git-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"@cyanheads/git-mcp-server\"],\n      \"env\": {\n        \"MCP_LOG_LEVEL\": \"info\",\n        \"GIT_SIGN_COMMITS\": \"false\"\n      }\n    }\n  }\n}\n```\n\n### \ud83c\udf0d NEW: Add to All Discovered Configurations\n```bash\n# Automatically discover and install to ALL MCP configurations\nmcp add-all myserver \"npx @modelcontextprotocol/server-filesystem /tmp\"\n\n# Works with JSON configurations too\nmcp add-all myserver '{\"command\": \"npx\", \"args\": [\"-y\", \"@modelcontextprotocol/server-memory\"]}'\n```\n\n### \ud83d\uddd1\ufe0f Server Removal\n```bash\n# Remove server from all configured editors\nmcp remove myserver\n\n# Remove server from specific editor\nmcp remove myserver cursor\n```\n\n### \u2139\ufe0f Help and Version\n```bash\n# Show help\nmcp --help\nmcp help  # Same as above\n\n# Show version\nmcp version\n```\n\n## Configuration\n\nMCP Commander automatically manages its configuration in platform-specific user directories:\n\n- **Windows**: `%APPDATA%/mcpCommander/config.json`\n- **macOS**: `~/Library/Application Support/mcpCommander/config.json`\n- **Linux**: `~/.config/mcpCommander/config.json`\n\nWhen you first run any command, mcpCommander will automatically:\n1. Create the user config directory\n2. Migrate any existing `config.json` from the repository\n3. Create a default config if none exists\n\nThe configuration defines which editors are supported and where their configuration files are located:\n\n```json\n{\n  \"editors\": {\n    \"claude-code\": {\n      \"config_path\": \"~/.claude.json\",\n      \"jsonpath\": \"mcpServers\"\n    },\n    \"claude-desktop\": {\n      \"config_path\": \"~/Library/Application Support/Claude/claude_desktop_config.json\",\n      \"jsonpath\": \"mcpServers\"\n    },\n    \"cursor\": {\n      \"config_path\": \"~/.cursor/mcp.json\",\n      \"jsonpath\": \"mcpServers\"\n    }\n  }\n}\n```\n\n### Adding New Editors\n\nTo add support for a new editor, simply add an entry to the `editors` object in `config.json`:\n\n```json\n{\n  \"editors\": {\n    \"new-editor\": {\n      \"config_path\": \"/path/to/editor/config.json\",\n      \"jsonpath\": \"mcpServers\"\n    }\n  }\n}\n```\n\nThe `jsonpath` field supports simple dot notation for nested JSON paths (e.g., `\"config.mcpServers\"`).\n\n## File Structure\n\n```\nmcpCommander/\n\u251c\u2500\u2500 config.json          # Editor configuration\n\u251c\u2500\u2500 mcp_manager.py       # Main Python script\n\u251c\u2500\u2500 mcp                  # Shell wrapper script\n\u2514\u2500\u2500 README.md           # This file\n```\n\n## Examples\n\n### Managing your JIRA MCP server\n\n```bash\n# Add JIRA server to all editors\nmcp add jira-mcp \"~/Projects/me/jira-mcp/server.py\"\n\n# List all configured servers\nmcp list\n\n# Remove from just Cursor\nmcp remove jira-mcp cursor\n\n# Check what's configured\nmcp status\n```\n\n### Adding a server with complex configuration\n\n```bash\nmcp add filesystem '{\"command\": \"npx\", \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem\", \"~/Documents\"]}'\n```\n\n## \ud83d\udee0\ufe0f Development\n\n### Local Development Setup\n```bash\n# Clone the repository\ngit clone https://github.com/nmindz/mcp-commander.git\ncd mcp-commander\n\n# Create virtual environment\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n\n# Install with development dependencies\npip install -e \".[dev]\"\n\n# Run tests\npytest tests/\n\n# Run linting and formatting\nblack src/ tests/\nflake8 src/ tests/\nmypy src/\n```\n\n### Project Structure\n```\nmcp-commander/\n\u251c\u2500\u2500 src/mcpcommander/          # Main package\n\u2502   \u251c\u2500\u2500 core/                  # Core business logic\n\u2502   \u251c\u2500\u2500 cli/                   # Command-line interface\n\u2502   \u251c\u2500\u2500 utils/                 # Utilities and helpers\n\u2502   \u2514\u2500\u2500 schemas/               # Pydantic schemas\n\u251c\u2500\u2500 tests/                     # Test suite\n\u2502   \u251c\u2500\u2500 unit/                  # Unit tests\n\u2502   \u251c\u2500\u2500 integration/           # Integration tests\n\u2502   \u2514\u2500\u2500 e2e/                   # End-to-end tests\n\u251c\u2500\u2500 docs/                      # Documentation\n\u2514\u2500\u2500 scripts/                   # Automation scripts\n```\n\n### Requirements\n- Python 3.12 or higher\n- Cross-platform (macOS, Windows, Linux)\n- Rich CLI output with colorized formatting\n\n## \ud83c\udd95 What's New in v2.0\n\n### \ud83d\udd0d **Auto-Discovery System**\n- Automatically finds all MCP configurations on your system\n- Supports Claude Code, Claude Desktop, Cursor, VS Code, and more\n- Cross-platform detection (macOS, Windows, Linux)\n\n### \ud83c\udf0d **Add-All Command**\n```bash\n# One command to rule them all!\nmcp add-all my-server \"npx @modelcontextprotocol/server-filesystem /tmp\"\n```\n- Discovers ALL MCP configurations automatically\n- Installs server to every found configuration\n- Detailed success/failure reporting with colors\n\n### \ud83d\udcca **Enhanced CLI Experience**\n- Rich table formatting for server listings\n- Colorized status indicators (\u2705\u274c\u26a0\ufe0f)\n- Comprehensive error messages with actionable guidance\n- Verbose logging options for debugging\n\n### \ud83c\udfd7\ufe0f **Modern Architecture**\n- Enterprise-grade error handling with custom exceptions\n- Type safety with comprehensive type hints\n- Extensive test coverage (85%+)\n- Modern Python packaging with pyproject.toml\n\n## \ud83d\udd27 Troubleshooting\n\n### Common Issues\n- **Configuration not found**: Run `mcp discover` to see all available MCP configurations\n- **Permission errors**: Ensure you have write access to editor configuration directories\n- **JSON validation errors**: Use `mcp status` to check configuration file integrity\n- **Server conflicts**: Use `mcp list` to see existing servers before adding new ones\n\n### Debug Mode\n```bash\n# Enable verbose output for debugging\nmcp add-all myserver \"command\" --verbose\nmcp list --verbose\n```\n\n### Getting Help\n```bash\n# Comprehensive help for any command\nmcp --help\nmcp add-all --help\n```\n",
    "bugtrack_url": null,
    "license": "Apache-2.0",
    "summary": "Cross-platform command-line tool for managing MCP (Model Context Protocol) servers across editors",
    "version": "0.1.2",
    "project_urls": {
        "Documentation": "https://github.com/nmindz/mcp-commander#readme",
        "Homepage": "https://github.com/nmindz/mcp-commander",
        "Issues": "https://github.com/nmindz/mcp-commander/issues",
        "Repository": "https://github.com/nmindz/mcp-commander"
    },
    "split_keywords": [
        "mcp",
        " model-context-protocol",
        " claude",
        " cursor",
        " vscode",
        " cli"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "af6c2d6f6a1a869581a8ba1eef5cd7a466dc71fcfd6f5a0bfb997392348eb204",
                "md5": "8ad78e9577fba1e323ae3dae8a345f89",
                "sha256": "911f40c10ada02306895df6a714793dc645497c2f6b8055eefd802ba9cd0b456"
            },
            "downloads": -1,
            "filename": "mcp_commander-0.1.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "8ad78e9577fba1e323ae3dae8a345f89",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.12",
            "size": 31036,
            "upload_time": "2025-08-13T20:26:25",
            "upload_time_iso_8601": "2025-08-13T20:26:25.698427Z",
            "url": "https://files.pythonhosted.org/packages/af/6c/2d6f6a1a869581a8ba1eef5cd7a466dc71fcfd6f5a0bfb997392348eb204/mcp_commander-0.1.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "0c8198ce58134b573503282612d4af9276a1a060252cc5d02d136c6e3616cdbc",
                "md5": "314f23a5b4d06702834be62a5c0f643d",
                "sha256": "0a83f368ad8d50cc36501f3ef686080aa532b2d6f5c0460e5e38491903abf48e"
            },
            "downloads": -1,
            "filename": "mcp_commander-0.1.2.tar.gz",
            "has_sig": false,
            "md5_digest": "314f23a5b4d06702834be62a5c0f643d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.12",
            "size": 178205,
            "upload_time": "2025-08-13T20:26:27",
            "upload_time_iso_8601": "2025-08-13T20:26:27.584769Z",
            "url": "https://files.pythonhosted.org/packages/0c/81/98ce58134b573503282612d4af9276a1a060252cc5d02d136c6e3616cdbc/mcp_commander-0.1.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-13 20:26:27",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "nmindz",
    "github_project": "mcp-commander#readme",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "colorama",
            "specs": [
                [
                    ">=",
                    "0.4.6"
                ]
            ]
        },
        {
            "name": "pydantic",
            "specs": [
                [
                    ">=",
                    "2.0.0"
                ]
            ]
        },
        {
            "name": "typer",
            "specs": [
                [
                    ">=",
                    "0.9.0"
                ]
            ]
        },
        {
            "name": "rich",
            "specs": [
                [
                    ">=",
                    "13.0.0"
                ]
            ]
        },
        {
            "name": "pytest",
            "specs": [
                [
                    ">=",
                    "7.4.0"
                ]
            ]
        },
        {
            "name": "pytest-cov",
            "specs": [
                [
                    ">=",
                    "4.1.0"
                ]
            ]
        },
        {
            "name": "pytest-mock",
            "specs": [
                [
                    ">=",
                    "3.11.0"
                ]
            ]
        },
        {
            "name": "mypy",
            "specs": [
                [
                    ">=",
                    "1.5.0"
                ]
            ]
        },
        {
            "name": "black",
            "specs": [
                [
                    ">=",
                    "23.7.0"
                ]
            ]
        },
        {
            "name": "flake8",
            "specs": [
                [
                    ">=",
                    "6.0.0"
                ]
            ]
        },
        {
            "name": "isort",
            "specs": [
                [
                    ">=",
                    "5.12.0"
                ]
            ]
        },
        {
            "name": "build",
            "specs": [
                [
                    ">=",
                    "0.10.0"
                ]
            ]
        },
        {
            "name": "twine",
            "specs": [
                [
                    ">=",
                    "4.0.0"
                ]
            ]
        }
    ],
    "lcname": "mcp-commander"
}
        
Elapsed time: 0.82694s