{"id":35094212,"url":"https://github.com/rohitsoni007/mcp-gearbox","last_synced_at":"2026-01-27T09:18:18.035Z","repository":{"id":322764936,"uuid":"1088709087","full_name":"rohitsoni007/mcp-gearbox","owner":"rohitsoni007","description":"A modern desktop application for managing Model Context Protocol (MCP) servers across multiple AI agents","archived":false,"fork":false,"pushed_at":"2025-11-20T12:29:34.000Z","size":1848,"stargazers_count":40,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-20T14:23:19.978Z","etag":null,"topics":["ai","ai-agents","ai-tools","claude-code","desktop-app","dev-tools","developer-tools","electron","gearbox","mcp","mcp-server","model-context-protocol","open-source","react","shadcn-ui","tailwindcss","tool","typescript"],"latest_commit_sha":null,"homepage":"https://rohitsoni007.github.io/mcp-gearbox","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/rohitsoni007.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-03T10:53:53.000Z","updated_at":"2025-11-20T12:29:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/rohitsoni007/mcp-gearbox","commit_stats":null,"previous_names":["rohitsoni007/mcp-gearbox"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/rohitsoni007/mcp-gearbox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohitsoni007%2Fmcp-gearbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohitsoni007%2Fmcp-gearbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohitsoni007%2Fmcp-gearbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohitsoni007%2Fmcp-gearbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rohitsoni007","download_url":"https://codeload.github.com/rohitsoni007/mcp-gearbox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohitsoni007%2Fmcp-gearbox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28234560,"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","status":"online","status_checked_at":"2026-01-07T02:00:05.975Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai","ai-agents","ai-tools","claude-code","desktop-app","dev-tools","developer-tools","electron","gearbox","mcp","mcp-server","model-context-protocol","open-source","react","shadcn-ui","tailwindcss","tool","typescript"],"created_at":"2025-12-27T15:04:24.313Z","updated_at":"2026-01-27T09:18:18.006Z","avatar_url":"https://github.com/rohitsoni007.png","language":"TypeScript","funding_links":[],"categories":["📚 Projects (1974 total)"],"sub_categories":["MCP Servers"],"readme":"# MCP Gearbox\n\n\u003e A modern desktop application for managing Model Context Protocol (MCP) servers across multiple AI agents\n\n## 📸 Screenshot\n\n![MCP Gearbox](media/mcp-gearbox.png)\n\n[![Build](https://github.com/rohitsoni007/mcp-gearbox/actions/workflows/build.yml/badge.svg)](https://github.com/rohitsoni007/mcp-gearbox/actions/workflows/build.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Electron](https://img.shields.io/badge/Electron-39.0.0-47848F?logo=electron)](https://www.electronjs.org/)\n[![React](https://img.shields.io/badge/React-19.2.0-61DAFB?logo=react)](https://reactjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.9.3-3178C6?logo=typescript)](https://www.typescriptlang.org/)\n[![GitHub Stars](https://img.shields.io/github/stars/rohitsoni007/mcp-gearbox?style=social)](https://github.com/rohitsoni007/mcp-gearbox)\n\n\n## 📚 Documentation\n\nFor detailed usage instructions, please visit our [documentation](https://rohitsoni007.github.io/mcp-gearbox).\n\n## 🤔 What is MCP Gearbox?\n\nMCP Gearbox is a powerful cross-platform desktop application that simplifies the management of Model Context Protocol (MCP) servers for AI agents like Claude, Kiro, Continue, Copilot, Cursor, Qoder, and others. Built with Electron, React, and TypeScript, this productivity tool provides an intuitive interface to discover, install, configure, and manage MCP servers without touching configuration files. Whether you're a developer, researcher, or AI enthusiast, MCP Gearbox streamlines your workflow with local AI integration and server management capabilities.\n\n### Key Features\n\nAs a cutting-edge productivity tool for AI development, MCP Gearbox offers:\n\n- **🔍 Server Discovery** - Browse and search through available MCP servers from the community\n- **⚡ One-Click Installation** - Install MCP servers to your AI agents with a single click\n- **🎛️ Multi-Agent Support** - Manage servers across multiple AI agents from one interface\n- **📊 Server Management** - Enable, disable, and remove servers with ease\n- **🔧 Configuration Made Easy** - No need to manually edit JSON configuration files\n- **🎨 Modern UI** - Built with shadcn/ui components and Tailwind CSS for a beautiful experience\n- **💾 State Persistence** - Your settings and preferences are saved automatically\n\nThese features make MCP Gearbox the ultimate productivity tool for developers working with AI assistants.\n\n## 💡 Why MCP Gearbox?\n\nManaging MCP servers manually can be tedious and error-prone. MCP Gearbox eliminates the complexity by offering a code assistant productivity tool that:\n\n- Provides a visual interface for server management\n- Automates configuration file updates\n- Offers server discovery and recommendations\n- Supports multiple AI agents in one place\n- Reduces setup time from minutes to seconds\n\nThis AI integration tool transforms how developers and researchers work with Model Context Protocol servers, making local AI setup effortless and efficient.\n\n## 💻 Installation\n\nGet started with this AI integration tool in minutes. MCP Gearbox supports all major operating systems.\n\n## 🔧 Requirements\n\n- [uv](https://docs.astral.sh/uv/) for package management\n- [Python 3.11+](https://www.python.org/downloads/)\n- [Git](https://git-scm.com/downloads)\n  \n\n### Download\n\nGet started immediately with our pre-built binaries for maximum convenience:\n\n- **Windows**: `mcp-gearbox-setup.exe`\n- **macOS Intel (x64)**: `mcp-gearbox-x64.dmg`\n- **macOS Apple Silicon (arm64)**: `mcp-gearbox-arm64.dmg`\n- **macOS Universal**: `mcp-gearbox-universal.dmg` *(runs on both Intel and Apple Silicon)*\n- **Linux**: `mcp-gearbox.deb` or `mcp-gearbox.rpm`\n\nThis cross-platform AI integration tool is ready to enhance your productivity workflow.\n\n### 🛠️ Build from Source\n\nBuild this productivity tool from source to customize it for your specific needs:\n\n```bash\n# Clone the repository\ngit clone https://github.com/rohitsoni007/mcp-gearbox.git\ncd mcp-gearbox\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm start\n\n# Build for production\nnpm run make\n```\n\nBuilding from source gives you the flexibility to extend MCP Gearbox as an AI integration tool.\n\n## 🎯 Usage\n\nUnlock the full potential of this productivity tool with these simple steps:\n\n### 🚀 Getting Started\n\n1. **Launch MCP Gearbox** - Open the application\n2. **Check Agent Status** - View which AI agents are installed and configured\n3. **Browse Servers** - Explore available MCP servers\n4. **Install Servers** - Click to add servers to your preferred agents\n5. **Manage Configuration** - Enable/disable servers as needed\n\nThis intuitive workflow makes managing AI assistants effortless.\n\n### 🖥️ Managing Servers\n\nEffortlessly control your AI assistant ecosystem with these management features:\n\n- **Add a Server**: Browse the server list and click \"Install\" on any server\n- **Remove a Server**: Navigate to your installed servers and click \"Remove\"\n- **Enable/Disable**: Toggle servers on or off without uninstalling\n\nThis server management capability makes MCP Gearbox the ultimate productivity tool for AI development.\n\n### 🤖 Supported AI Agents\n\nMCP Gearbox seamlessly integrates with popular AI code assistants and development tools:\n\n| Agent | Support | Notes |\n|-------|---------|-------|\n| **[GitHub Copilot](https://code.visualstudio.com)** | ✅ |  |\n| **[Continue](https://github.com/continuedev/continue)** | ✅ |  |\n| **[Kiro](https://kiro.dev)** | ✅ |  |\n| **[Cursor](https://cursor.sh)** | ✅ |  |\n| **[Claude Code](https://www.claude.com/product/claude-code)** | ✅ |  |\n| **[Gemini CLI](https://github.com/google-gemini/gemini-cli)** | ✅ |  |\n| **[Qoder](https://qoder.com)** | ✅ |  |\n| **[Copilot CLI](https://github.com/github/copilot-cli)** | ✅ |  |\n| **[LM Studio](https://lmstudio.ai)** | ✅ |  |\n| **[Google Antigravity](https://antigravity.google)** | ✅ |  |\n\n## ⚙️ Technology Stack\n\n- **Framework**: Electron 39 with Electron Forge\n- **Frontend**: React 19 with TypeScript\n- **Routing**: TanStack Router\n- **State Management**: Redux Toolkit with Redux Persist\n- **UI Components**: shadcn/ui with Radix UI primitives\n- **Styling**: Tailwind CSS 4\n- **Build Tool**: Vite (Rolldown)\n- **Testing**: Vitest + Playwright\n\n## Development\n\nJoin us in improving this AI integration tool for the developer community. We use modern development practices to ensure code quality and maintainability.\n\n### 📁 Project Structure\n\nOur well-organized codebase follows modern development practices for this productivity tool:\n\n```\nmcp-gearbox/\n├── src/\n│   ├── components/     # React components\n│   ├── hooks/          # Custom React hooks\n│   ├── pages/          # Page components\n│   ├── services/       # API and service layer\n│   ├── store/          # Redux store and slices\n│   ├── types/          # TypeScript type definitions\n│   ├── utils/          # Utility functions\n│   ├── main.ts         # Electron main process\n│   ├── preload.ts      # Electron preload script\n│   └── renderer.tsx    # React renderer entry\n├── tests/              # E2E tests\n└── forge.config.ts     # Electron Forge configuration\n```\n\nThis modular structure makes MCP Gearbox easy to understand and extend as an AI integration tool.\n\n### 📜 Available Scripts\n\nStreamline your development workflow with these npm scripts for this AI integration tool:\n\n```bash\nnpm start              # Start development server\nnpm run build          # Build for production\nnpm run make           # Create distributable packages\nnpm run lint           # Run ESLint\nnpm run format         # Format code with Prettier\nnpm test               # Run unit tests\nnpm run test:e2e       # Run end-to-end tests\n```\n\nThese scripts ensure consistent development practices for contributing to this productivity tool.\n\n### 🧪 Testing\n\nWe maintain high quality standards for this productivity tool through comprehensive testing:\n\n```bash\n# Unit tests with Vitest\nnpm test\nnpm run test:watch\nnpm run test:coverage\n\n# E2E tests with Playwright\nnpm run test:e2e\nnpm run test:e2e:ui\n```\n\nOur testing approach ensures MCP Gearbox remains a reliable AI integration tool for developers.\n\nWe follow best practices for testing to ensure MCP Gearbox remains a reliable productivity tool.\n\n## 🤝 Contributing\n\nWe welcome contributions from the AI development community! Whether you're a seasoned developer or new to AI tools, your input helps make MCP Gearbox better for everyone. Please see our [CONTRIBUTING.md](CONTRIBUTING.md) for details on:\n\n- Code of Conduct\n- Development setup\n- Submitting pull requests\n- Reporting issues\n- Coding standards\n\nJoin us in building the ultimate productivity tool for AI assistant management.\n\n## 📄 License\n\nThis open-source productivity tool is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. The permissive MIT license allows you to use, modify, and distribute MCP Gearbox for both personal and commercial projects.\n\n## 💬 Support\n\nNeed help with this AI integration tool or have questions about managing MCP servers? We're here to help:\n\n- **Issues**: [GitHub Issues](https://github.com/rohitsoni007/mcp-gearbox/issues) - Report bugs or request features\n- **Discussions**: [GitHub Discussions](https://github.com/rohitsoni007/mcp-gearbox/discussions) - Ask questions and connect with other users\n\nAs a productivity tool for AI developers, we strive to provide excellent support for our community.\n\n## 🗺️ Roadmap\n\nOur future plans for enhancing this AI integration tool include:\n\n- [ ] Server configuration editor\n- [ ] Custom server addition\n- [ ] Server health monitoring\n- [ ] Backup and restore configurations\n- [ ] Dark/light theme toggle\n- [ ] Multi-language support\n\n## 🙏 Acknowledgements\n\nThis project is based on the data from [Model Context Protocol Servers](https://github.com/modelcontextprotocol/servers) and [Github MCP Registry](https://github.com/mcp).\nThis project uses my other project  [MCP-Gearbox-CLI](https://github.com/rohitsoni007/mcp-gearbox-cli).\n\nWe're continuously working to improve MCP Gearbox as a productivity tool for the AI development community.\n\n---\n\n**Keywords**: MCP, Model Context Protocol, AI agents, Claude Desktop, Kiro, Electron app, server management, AI tools, desktop application, TypeScript, React, MCP servers, AI configuration, developer tools, AI assistant, local AI, MCP client, AI integration, code assistant, productivity tool, cross-platform app\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frohitsoni007%2Fmcp-gearbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frohitsoni007%2Fmcp-gearbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frohitsoni007%2Fmcp-gearbox/lists"}