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.

!MCP Manager Screenshot

Features

!MCP Manager Screenshot

• 🖥️ 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:

• macOS (DMG)
• macOS (ZIP)

Building from Source

If you prefer to build the application yourself:

1. Clone the repository:

   git clone https://github.com/iagolast/mcp-manager.git
   cd mcp-manager
   

2. Install dependencies:

   npm install
   

3. Build the application:

   npm run build
   

4. Create distributables:

   npm run dist
   

The built application will be available in the release directory.

Development

Running in Development Mode

1. Clone the repository and install dependencies:

   git clone https://github.com/iagolast/mcp-manager.git
   cd mcp-manager
   npm install
   

2. 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 components
• src/renderer/services: Services for managing configuration and server communication
• src/renderer/types: TypeScript type definitions
• electron: 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.

1. Fork the repository
2. Create your feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add some amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. 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