A modern desktop application for managing Model Context Protocol (MCP) servers across multiple AI agents
For detailed usage instructions, please visit our documentation.
MCP Gearbox is a powerful desktop application that simplifies the management of Model Context Protocol (MCP) servers for AI agents like Claude, Kiro, and others. Built with Electron, React, and TypeScript, it provides an intuitive interface to discover, install, configure, and manage MCP servers without touching configuration files.
- 🔍 Server Discovery - Browse and search through available MCP servers from the community
- ⚡ One-Click Installation - Install MCP servers to your AI agents with a single click
- 🎛️ Multi-Agent Support - Manage servers across multiple AI agents from one interface
- 📊 Server Management - Enable, disable, and remove servers with ease
- 🔧 Configuration Made Easy - No need to manually edit JSON configuration files
- 🎨 Modern UI - Built with shadcn/ui components and Tailwind CSS for a beautiful experience
- 💾 State Persistence - Your settings and preferences are saved automatically
Managing MCP servers manually can be tedious and error-prone. MCP Gearbox eliminates the complexity by:
- Providing a visual interface for server management
- Automating configuration file updates
- Offering server discovery and recommendations
- Supporting multiple AI agents in one place
- Reducing setup time from minutes to seconds
- Node.js 18 or higher
- npm package manager
- Linux/macOS/Windows
- uv for package management
- Python 3.11+
- Git
Download the latest release for your platform:
- Windows:
mcp-gearbox-setup.exe - macOS:
mcp-gearbox.dmg - Linux:
mcp-gearbox.debormcp-gearbox.rpm
# Clone the repository
git clone https://github.com/rohitsoni007/mcp-gearbox.git
cd mcp-gearbox
# Install dependencies
npm install
# Run in development mode
npm start
# Build for production
npm run make- Launch MCP Gearbox - Open the application
- Check Agent Status - View which AI agents are installed and configured
- Browse Servers - Explore available MCP servers
- Install Servers - Click to add servers to your preferred agents
- Manage Configuration - Enable/disable servers as needed
- Add a Server: Browse the server list and click "Install" on any server
- Remove a Server: Navigate to your installed servers and click "Remove"
- Enable/Disable: Toggle servers on or off without uninstalling
| Agent | Support | Notes |
|---|---|---|
| GitHub Copilot | ✅ | |
| Continue | ✅ | |
| Kiro | ✅ | |
| Cursor | ✅ | |
| Claude Code | ✅ | |
| Gemini CLI | ✅ | |
| Qoder | ✅ | |
| Copilot CLI | ✅ | |
| LM Studio | ✅ |
- Framework: Electron 39 with Electron Forge
- Frontend: React 19 with TypeScript
- Routing: TanStack Router
- State Management: Redux Toolkit with Redux Persist
- UI Components: shadcn/ui with Radix UI primitives
- Styling: Tailwind CSS 4
- Build Tool: Vite (Rolldown)
- Testing: Vitest + Playwright
mcp-gearbox/
├── src/
│ ├── components/ # React components
│ ├── hooks/ # Custom React hooks
│ ├── pages/ # Page components
│ ├── services/ # API and service layer
│ ├── store/ # Redux store and slices
│ ├── types/ # TypeScript type definitions
│ ├── utils/ # Utility functions
│ ├── main.ts # Electron main process
│ ├── preload.ts # Electron preload script
│ └── renderer.tsx # React renderer entry
├── tests/ # E2E tests
└── forge.config.ts # Electron Forge configuration
npm start # Start development server
npm run build # Build for production
npm run make # Create distributable packages
npm run lint # Run ESLint
npm run format # Format code with Prettier
npm test # Run unit tests
npm run test:e2e # Run end-to-end tests# Unit tests with Vitest
npm test
npm run test:watch
npm run test:coverage
# E2E tests with Playwright
npm run test:e2e
npm run test:e2e:uiWe welcome contributions! Please see our CONTRIBUTING.md for details on:
- Code of Conduct
- Development setup
- Submitting pull requests
- Reporting issues
- Coding standards
This project is licensed under the MIT License - see the LICENSE file for details.
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Server configuration editor
- Custom server addition
- Server health monitoring
- Backup and restore configurations
- Dark/light theme toggle
- Multi-language support
- Built with Electron Forge
- UI components from shadcn/ui
- Icons from Lucide
- Inspired by the MCP community
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