MCP Manager
MCP Manager is an Electron-based desktop application for managing Model Context Protocol (MCP) servers. It provides an intuitive graphical interface to configure, monitor, and manage MCP servers with ease.
Features
- 🖥️ Visual Server Management: Add, edit, and remove MCP servers through a user-friendly interface.
- 🔄 Real-time Status Monitoring: Check the status of your servers with one click.
- 🛠️ Advanced Configuration: Customize command, arguments, and environment variables for each server.
- 📋 JSON Import/Export: Import and export server configurations in JSON format.
- 🔍 Direct JSON Editing: View and edit the raw configuration file if needed.
Installation
Direct Download
You can download the latest pre-built application for your platform:
Building from Source
If you prefer to build the application yourself:
-
Clone the repository:
git clone https://github.com/iagolast/mcp-manager.git cd mcp-manager
-
Install dependencies:
npm install
-
Build the application:
npm run build
-
Create distributables:
npm run dist
The built application will be available in the release
directory.
Development
Running in Development Mode
-
Clone the repository and install dependencies:
git clone https://github.com/iagolast/mcp-manager.git cd mcp-manager npm install
-
Start the development server:
npm run dev
This will launch both the Vite development server for the React frontend and the Electron application.
Project Structure
src/renderer
: React application code (UI components)src/renderer/components
: React componentssrc/renderer/services
: Services for managing configuration and server communicationsrc/renderer/types
: TypeScript type definitionselectron
: Electron main process code
Testing
Run the tests with:
npm test
For development with continuous testing:
npm run test:watch
Configuration
MCP Manager stores its configuration in:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Linux:
~/.config/Claude/claude_desktop_config.json
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch:
git checkout -b feature/amazing-feature
- Commit your changes:
git commit -m 'Add some amazing feature'
- Push to the branch:
git push origin feature/amazing-feature
- Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgements
- Built with Electron
- Frontend developed with React and TypeScript
- UI styled with CSS-in-JS techniques