{"id":30054633,"url":"https://github.com/lisaross/cc-mcp","last_synced_at":"2026-04-13T13:31:54.126Z","repository":{"id":308216755,"uuid":"1030914846","full_name":"lisaross/cc-mcp","owner":"lisaross","description":"Minimal CLI tool for managing Model Context Protocol (MCP) servers in Claude Code projects","archived":false,"fork":false,"pushed_at":"2025-09-26T00:32:50.000Z","size":212,"stargazers_count":0,"open_issues_count":8,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-26T02:45:38.722Z","etag":null,"topics":["claude-code","cli","configuration-management","deno","mcp","typescript"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/lisaross.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY_VALIDATION.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-02T15:51:27.000Z","updated_at":"2025-09-26T00:32:52.000Z","dependencies_parsed_at":"2025-09-26T02:28:41.338Z","dependency_job_id":"30d9a6e7-7533-4197-a0e0-f9f1fa38759c","html_url":"https://github.com/lisaross/cc-mcp","commit_stats":null,"previous_names":["lisaross/cc-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lisaross/cc-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lisaross%2Fcc-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lisaross%2Fcc-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lisaross%2Fcc-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lisaross%2Fcc-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lisaross","download_url":"https://codeload.github.com/lisaross/cc-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lisaross%2Fcc-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31754846,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T13:27:56.013Z","status":"ssl_error","status_checked_at":"2026-04-13T13:21:23.512Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-code","cli","configuration-management","deno","mcp","typescript"],"created_at":"2025-08-07T21:00:59.310Z","updated_at":"2026-04-13T13:31:54.112Z","avatar_url":"https://github.com/lisaross.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CC-MCP: Claude Code MCP Manager\n\nA **minimal** command-line tool that solves a critical problem: **Claude Code's built-in disable button permanently deletes MCP configurations**.\n\nCC-MCP preserves your MCP setups when disabling them, enabling instant re-activation without reconfiguration.\n\n## The Problem\n\nWhen you disable an MCP using Claude Code's built-in UI, it permanently deletes the configuration from `mcp.json`. For MCPs with complex setups (API keys, custom paths, environment variables), this means complete reconfiguration from scratch.\n\n**User Pain:** *\"I spent 20 minutes setting up my database MCP with connection strings and API keys. I disabled it for a design task, and now it's completely gone. I have to start over.\"*\n\n## The Solution\n\nCC-MCP moves MCP configurations between `mcp.json` (enabled) and `mcp.json.disabled` (disabled) instead of deleting them.\n\n**Result:** Instant re-enabling without losing any configuration data.\n\n## Installation\n\n### Quick Install (Recommended)\n\n```bash\n# One-command installation\ncurl -fsSL https://raw.githubusercontent.com/lisaross/cc-mcp/main/install.sh | sh\n```\n\nThis script will:\n- Check for Deno installation (and help install if missing)\n- Configure PATH automatically\n- Install CC-MCP globally\n- Verify the installation\n- Show quick start instructions\n\n### Manual Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/lisaross/cc-mcp.git\ncd cc-mcp\n\n# Install globally  \ndeno install --global --allow-read --allow-write --name cc-mcp --force src/mvp/cc-mcp-mvp.ts\n\n# Add to PATH (if needed)\nexport PATH=\"/Users/$USER/.deno/bin:$PATH\"\n\n# Test installation\ncc-mcp --help\n```\n\n### Alternative: Run Directly\n\n```bash\n# Clone and run without installation\ngit clone https://github.com/lisaross/cc-mcp.git\ncd cc-mcp\n\n# Run directly\ndeno run --allow-read --allow-write src/mvp/cc-mcp-mvp.ts\n\n# Or use the task runner\ndeno task mvp\n```\n\n**Permissions needed:**\n\n- `--allow-read`: Read MCP configuration files\n- `--allow-write`: Write MCP configuration files\n\n### ⚠️ Important: Claude Code Restart Requirement\n\n**Add this to your global Claude Code memory** (`~/.claude/CLAUDE.md`):\n\n```markdown\n## CC-MCP Usage Notes\n- When CC-MCP shows \"⚠️ Restart Claude Code for changes to take effect:\", inform the user that a restart is required before MCP changes take effect\n- If no restart occurs within 30 seconds, continue with a warning that MCP changes may not be active\n- MCP changes only take effect after Claude Code restarts\n```\n\n## Usage\n\n```bash\n# Show all MCPs with status (default action)\ncc-mcp\ncc-mcp list\ncc-mcp ls\n\n# Enable a specific MCP \ncc-mcp enable github\ncc-mcp e github\n\n# Disable a specific MCP (preserves configuration)\ncc-mcp disable github  \ncc-mcp d github\n\n# Initialize with working examples\ncc-mcp init\n```\n\n## First Run\n\nOn first use, CC-MCP automatically creates:\n\n- `mcp.json` with **filesystem** MCP enabled (safe, immediately useful)\n- `mcp.json.disabled` with **github** MCP example (with placeholder token)\n\nYou can start using the filesystem MCP right away, then configure other MCPs as needed.\n\n## Example Workflow\n\n```bash\n# See current status\n$ cc-mcp\n\u0013 filesystem\n\u0017 github\n\n# Enable GitHub MCP (after adding your token to mcp.json.disabled)\n$ cc-mcp enable github\n\u0013 Enabled github\n�\u000f  Restart Claude Code: claude -c\n\n# Later, disable for context management\n$ cc-mcp disable github\n\u0013 Disabled github (configuration preserved)\n�\u000f  Restart Claude Code: claude -c\n\n# Re-enable instantly - no reconfiguration needed!\n$ cc-mcp enable github\n\u0013 Enabled github\n�\u000f  Restart Claude Code: claude -c\n```\n\n**Key Point:** The configuration is preserved in `.mcp.json.disabled`, so re-enabling requires zero setup.\n\n## Key Benefits\n\n- **Configuration Preservation**: Never lose MCP setups again\n- **Instant Re-enabling**: No reconfiguration required\n- **Context Management**: Enable only MCPs needed for current task\n- **Zero Learning Curve**: Works immediately with auto-scaffolding\n- **Safe**: Never destructively edits configurations\n\n## Configuration Files\n\n- `mcp.json`: Currently enabled MCP servers\n- `mcp.json.disabled`: Disabled MCP servers (configurations preserved)\n\n## Requirements\n\n- **Deno** (for macOS: `brew install deno`)\n- **Claude Code** project with MCP support\n- Write permissions in project directory\n\n## MVP Scope\n\nThis is a **true MVP** focused solely on configuration preservation:\n\n\u0005 **Included**: List, enable, disable, auto-scaffolding  \nL **Deferred**: Interactive modes, complex prompts, backup systems\n\nFuture versions will add more features based on user feedback.\n\n## Contributing\n\nFound a bug or want a feature? [Open an issue](https://github.com/lisaross/cc-mcp/issues).\n\nThis project follows MVP principles - we ship simple, working solutions and iterate based on real user needs.\n\n---\n\n**Warning:** Do not use Claude Code's built-in disable button for MCPs - it permanently deletes configurations. Always use CC-MCP for preserving your setups.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flisaross%2Fcc-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flisaross%2Fcc-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flisaross%2Fcc-mcp/lists"}