What is Mcphub

MCPHub is a cross-platform GUI application designed to discover, install, and manage Model Context Protocol (MCP) servers. It functions similarly to package managers like apt or pip, but specifically for MCP servers.

Use cases

MCPHub is ideal for developers and users who need to manage multiple MCP servers efficiently, integrate with Claude Desktop, or monitor server statuses in real-time.

How to use

To use MCPHub, install the Chrome extension and the native host by following the provided installation scripts for your operating system. After installation, you can browse, install, and manage MCP servers through the web interface or the extension.

Key features

MCPHub offers features such as browsing and installing MCP servers, managing server configurations, secure local operations via a Chrome extension, real-time status monitoring, and cross-platform support.

Where to use

undefined

MCPHub 🚀

MCPHub is a hybrid web/extension application for managing Model Context Protocol (MCP) servers. Think of it as apt/pip but for MCP servers, with a modern web interface and secure local system integration.

🌟 Features

• 📦 Browse and install MCP servers
• ⚙️ Manage server configurations
• 🔐 Secure local operations through Chrome extension
• 🌐 Web-based interface
• 🔄 Real-time status monitoring
• 🛠️ Environment variable management
• 📝 Claude Desktop config integration
• 🖥️ Cross-platform support

🚀 Quick Start

Install Chrome Extension and Native Host

Windows:

1. Clone this repository
2. Run installation script:

cd chrome-extension/scripts
windows-install.bat

3. Load the extension in Chrome:
   • Open chrome://extensions/
   • Enable Developer mode
   • Click “Load unpacked”
   • Select the chrome-extension directory

MacOS/Linux:

1. Clone this repository
2. Run installation script:

cd chrome-extension/scripts
# For MacOS:
./macos-install.sh
# For Linux:
./linux-install.sh

3. Load the extension in Chrome:
   • Open chrome://extensions/
   • Enable Developer mode
   • Click “Load unpacked”
   • Select the chrome-extension directory

Run Web Frontend

1. Navigate to web directory:

cd web

2. Install dependencies:

npm install

3. Start development server:

npm run dev

4. Open http://localhost:3000 in Chrome

📁 Project Structure

mcphub/
├── chrome-extension/       # Chrome extension
│   ├── manifest.json      # Extension manifest
│   ├── background.js      # Service worker
│   ├── popup/            # Extension popup UI
│   ├── native-host/      # Native messaging host
│   └── scripts/          # Installation scripts
├── web/                  # Next.js frontend
│   ├── src/             # Source code
│   └── package.json     # Dependencies
└── registry/            # Server registry
    └── servers.yaml     # Available servers

⚙️ Configuration

Claude Desktop Integration

MCPHub manages the Claude Desktop config file located at:

• Windows: %APPDATA%/Claude/claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Server Configuration Example

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": [
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

🔄 Development

Chrome Extension

• Uses Manifest V3
• Native messaging for system operations
• Auto-generated extension ID
• Cross-platform installation scripts

Web Frontend

• Next.js 13 with TypeScript
• Material-UI components
• Chrome extension integration
• Real-time status monitoring

🤝 Contributing

1. Fork the repository
2. Create your feature branch:

git checkout -b feature/amazing-feature

3. Commit your changes:

git commit -m 'Add amazing feature'

4. Push to the branch:

git push origin feature/amazing-feature

5. Open a Pull Request

Adding New MCP Servers

Add your server to registry/servers.yaml:

- name: "Your MCP Server"
  description: "Server description"
  runtime: "node"  # or "python"
  package: "your-package-name"
  version: "1.0.0"
  command_args:
    - "your-command-args"
  env:
    YOUR_ENV_VAR: ""

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• Documentation
• Issue Tracker
• Model Context Protocol