{"id":28796017,"url":"https://github.com/qdhenry/claude-code-mcp-manager","last_synced_at":"2026-04-30T16:34:24.316Z","repository":{"id":299122432,"uuid":"1002126367","full_name":"qdhenry/Claude-Code-MCP-Manager","owner":"qdhenry","description":" A comprehensive tool to manage Model Context Protocol (MCP) configurations for Claude code","archived":false,"fork":false,"pushed_at":"2025-06-14T19:17:26.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-14T20:29:55.783Z","etag":null,"topics":["claude-ai","claude-code","claude-mcp","devtools","mcp","mcp-manager","model-context-protocol","productivity","shell-script"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qdhenry.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-14T19:14:26.000Z","updated_at":"2025-06-14T19:31:15.000Z","dependencies_parsed_at":"2025-06-14T20:31:59.727Z","dependency_job_id":"4ef1792e-3106-46bd-a6e0-d0e85996a3a2","html_url":"https://github.com/qdhenry/Claude-Code-MCP-Manager","commit_stats":null,"previous_names":["qdhenry/claude-code-mcp-manager"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/qdhenry/Claude-Code-MCP-Manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qdhenry%2FClaude-Code-MCP-Manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qdhenry%2FClaude-Code-MCP-Manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qdhenry%2FClaude-Code-MCP-Manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qdhenry%2FClaude-Code-MCP-Manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qdhenry","download_url":"https://codeload.github.com/qdhenry/Claude-Code-MCP-Manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qdhenry%2FClaude-Code-MCP-Manager/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260477919,"owners_count":23015068,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-ai","claude-code","claude-mcp","devtools","mcp","mcp-manager","model-context-protocol","productivity","shell-script"],"created_at":"2025-06-18T03:10:55.573Z","updated_at":"2026-04-30T16:34:24.311Z","avatar_url":"https://github.com/qdhenry.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP Manager - Setup and Usage Guide\n\n## Overview\n\nMCP Manager is a comprehensive bash script that helps you manage Model Context Protocol (MCP) configurations for Claude Code. It allows you to easily add, remove, list, and automatically load MCP configurations without manual intervention.\n\n## Features\n\n- **List MCPs** - View all configured MCPs in the correct format\n- **Add/Remove MCPs** - Manage your MCP configurations interactively\n- **Batch Operations** - Add all MCPs at once without prompts\n- **Auto-loading** - Automatically load MCPs when starting Claude Code\n- **Import/Export** - Save and restore your MCP configurations\n- **Sample Configurations** - Initialize with common MCP setups\n\n## Prerequisites\n\n- **Bash shell** (works with both bash and zsh)\n- **jq** - Command-line JSON processor\n  - macOS: `brew install jq`\n  - Ubuntu/Debian: `sudo apt-get install jq`\n  - RHEL/CentOS: `sudo yum install jq`\n  - Arch Linux: `sudo pacman -S jq`\n\n## Installation\n\n### Option 1: Direct Download\n\n```bash\n# Download the script\ncurl -O https://raw.githubusercontent.com/qdhenry/Claude-Code-MCP-Manager/main/mcp-manager.sh\n\n# Make it executable\nchmod +x mcp-manager.sh\n\n# Move to a location in your PATH (optional)\nsudo mv mcp-manager.sh /usr/local/bin/mcp-manager\n```\n\n### Option 2: Clone Repository\n\n```bash\n# Clone the repository\ngit clone https://github.com/qdhenry/Claude-Code-MCP-Manager.git\n\n# Navigate to the directory\ncd Claude-Code-MCP-Manager\n\n# Make the script executable\nchmod +x mcp-manager.sh\n\n# Create a symbolic link (optional)\nsudo ln -s $(pwd)/mcp-manager.sh /usr/local/bin/mcp-manager\n```\n\n## Quick Start\n\n1. **Initialize with sample MCPs:**\n   ```bash\n   ./mcp-manager.sh init\n   ```\n\n2. **Edit the configuration to add your tokens:**\n   ```bash\n   nano ~/.config/claude/mcp_config.json\n   ```\n   Replace `\u003cyour-token\u003e` placeholders with actual tokens.\n\n3. **List all MCPs:**\n   ```bash\n   ./mcp-manager.sh list\n   ```\n\n4. **Add all MCPs to Claude:**\n   ```bash\n   ./mcp-manager.sh add-all\n   ```\n\n## Usage\n\n### Basic Commands\n\n```bash\n# List all configured MCPs\n./mcp-manager.sh list\n# or\n./mcp-manager.sh ls\n\n# Add a new MCP interactively\n./mcp-manager.sh add\n\n# Add all MCPs without prompts\n./mcp-manager.sh add-all\n\n# Remove an MCP\n./mcp-manager.sh remove \u003cmcp_name\u003e\n# or\n./mcp-manager.sh rm \u003cmcp_name\u003e\n\n# Show details of a specific MCP\n./mcp-manager.sh show \u003cmcp_name\u003e\n\n# Export configurations\n./mcp-manager.sh export [filename]\n\n# Import configurations\n./mcp-manager.sh import \u003cfilename\u003e\n\n# Initialize with sample MCPs\n./mcp-manager.sh init\n\n# Set up automatic loading\n./mcp-manager.sh setup-auto\n\n# Show help\n./mcp-manager.sh help\n```\n\n### Configuration File\n\nThe configuration is stored in `~/.config/claude/mcp_config.json`. Here's the structure:\n\n```json\n{\n  \"mcps\": [\n    {\n      \"name\": \"supabase\",\n      \"type\": \"npx\",\n      \"path\": \"supabase/mcp-server-supabase@latest\",\n      \"options\": \"--access-token YOUR_TOKEN_HERE\"\n    },\n    {\n      \"name\": \"digitalocean\",\n      \"type\": \"env\",\n      \"path\": \"DIGITALOCEAN_API_TOKEN=YOUR_TOKEN_HERE\",\n      \"options\": \"npx -y @digitalocean/mcp\"\n    }\n  ]\n}\n```\n\n### MCP Types\n\n1. **NPX Type** - For npm packages:\n   ```json\n   {\n     \"name\": \"puppeteer\",\n     \"type\": \"npx\",\n     \"path\": \"modelcontextprotocol/server-puppeteer\",\n     \"options\": \"\"\n   }\n   ```\n\n2. **ENV Type** - For environment variables:\n   ```json\n   {\n     \"name\": \"digitalocean\",\n     \"type\": \"env\",\n     \"path\": \"DIGITALOCEAN_API_TOKEN=your-token\",\n     \"options\": \"npx -y @digitalocean/mcp\"\n   }\n   ```\n\n## Automatic Loading Setup\n\nTo automatically load all MCPs when starting Claude Code:\n\n### Method 1: Shell Function (Recommended)\n\n1. Run the setup command:\n   ```bash\n   ./mcp-manager.sh setup-auto\n   ```\n\n2. Reload your shell:\n   ```bash\n   source ~/.bashrc  # or ~/.zshrc for zsh\n   ```\n\n3. Start Claude Code with auto-loaded MCPs:\n   ```bash\n   claude-code\n   # or use the alias\n   cc\n   ```\n\n### Method 2: Custom Alias\n\nAdd to your `.bashrc` or `.zshrc`:\n\n```bash\nalias claude-start='/path/to/mcp-manager.sh add-all \u0026\u0026 claude-code'\n```\n\n### Method 3: Wrapper Script\n\nCreate a custom launcher script:\n\n```bash\n#!/bin/bash\necho \"Starting Claude Code with MCPs...\"\n/path/to/mcp-manager.sh add-all\nclaude-code \"$@\"\n```\n\n## Examples\n\n### Adding a New MCP\n\n```bash\n$ ./mcp-manager.sh add\nAdd new MCP configuration\n\nMCP Name: github\nType (npx/env): npx\nPath/Package: @github/mcp-server@latest\nAdditional options (press Enter for none): \n\nSuccessfully added MCP: github\n```\n\n### Batch Import/Export\n\n```bash\n# Export current configuration\n./mcp-manager.sh export my-mcps-backup.json\n\n# Import from a file\n./mcp-manager.sh import team-mcps.json\n```\n\n### Setting Up Common MCPs\n\nAfter running `./mcp-manager.sh init`, you'll get these pre-configured MCPs:\n\n- **Supabase** - Database and authentication\n- **DigitalOcean** - Cloud infrastructure management\n- **Shopify Dev** - E-commerce development tools\n- **Puppeteer** - Browser automation\n- **Upstash** - Redis and Kafka services\n- **Context7** - Context management\n- **Bright Data** - Web scraping and data collection\n\n## Troubleshooting\n\n### Issue: \"jq is required but not installed\"\n**Solution:** Install jq using your package manager (see Prerequisites)\n\n### Issue: \"Config file not found\"\n**Solution:** The script will automatically create the config file. Run any command to initialize it.\n\n### Issue: MCPs not loading automatically\n**Solution:** \n1. Ensure the script path is correct in your shell function\n2. Check if Claude Code is installed and accessible\n3. Verify your shell configuration was reloaded\n\n### Issue: \"Permission denied\"\n**Solution:** Make sure the script is executable:\n```bash\nchmod +x mcp-manager.sh\n```\n\n## Advanced Usage\n\n### Custom Configuration Location\n\nTo use a different configuration file location, modify the `CONFIG_FILE` variable in the script:\n\n```bash\nCONFIG_FILE=\"$HOME/.config/custom/mcp_config.json\"\n```\n\n### Adding Complex MCPs\n\nFor MCPs with multiple environment variables:\n\n```json\n{\n  \"name\": \"complex-mcp\",\n  \"type\": \"env\",\n  \"path\": \"VAR1=value1 VAR2=value2\",\n  \"options\": \"npx -y @complex/mcp-server --port 3000\"\n}\n```\n\n### Conditional Loading\n\nCreate a wrapper function that loads different MCPs based on the project:\n\n```bash\nclaude-project() {\n  if [[ $PWD == *\"web-project\"* ]]; then\n    mcp-manager add supabase puppeteer\n  elif [[ $PWD == *\"data-project\"* ]]; then\n    mcp-manager add upstash context7\n  fi\n  claude-code \"$@\"\n}\n```\n\n## Best Practices\n\n1. **Keep tokens secure** - Never commit your configuration file with real tokens\n2. **Regular backups** - Export your configuration regularly\n3. **Version control** - Keep your MCP configurations in a private git repository\n4. **Team sharing** - Use import/export to share configurations (without tokens)\n5. **Minimal MCPs** - Only load the MCPs you need for better performance\n\n## Contributing\n\nTo contribute to the MCP Manager project:\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## License\n\nThis project is open source and available under the MIT License.\n\n## Support\n\nFor issues, questions, or contributions:\n- Create an issue on GitHub\n- Check existing issues for solutions\n- Read the Claude Code documentation for MCP-specific questions\n\n---\n\n**Note:** Remember to replace placeholder tokens with your actual API tokens before using the MCPs.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqdhenry%2Fclaude-code-mcp-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqdhenry%2Fclaude-code-mcp-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqdhenry%2Fclaude-code-mcp-manager/lists"}