P

mcphub

...
Created 12/21/2024byhemangjoshi37a

Language:

Python

Stars:

6

Forks:

1

MCPHub šŸš€

Web Extension License Model Context Protocol PRs Welcome

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
  1. 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
  1. 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
  1. Install dependencies:
npm install
  1. Start development server:
npm run dev
  1. 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
  1. Commit your changes:
git commit -m 'Add amazing feature'
  1. Push to the branch:
git push origin feature/amazing-feature
  1. 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](LICENSE) file for details.

šŸ”— Links


Made with ā¤ļø by the MCPHub community

Last updated: 3/4/2025

Publisher info

hemangjoshi37a's avatar

Hemang Joshi

IIOT | ML/AI | ALGOTRADING

hjLabs.in
Bharat
72
followers
14
following
84
repos

More MCP servers built with Python

MCP Server for Bing Webmaster Tools

An MCP (Model Context Protocol) server that provides access to Bing Webmaster Tools functionality

By isiahw1
usgs-water-mcp

This MCP server provides access to real-time water data from the USGS Water Services API. It allows you to fetch instantaneous water measurements including stream flow, gage height, temperature, and other water quality parameters from thousands of monitoring stations across the United States.

By pgiffy
screeny

Privacy-focused macOS MCP server for secure, user-approved window screenshots

By rohanrav