mcphub
Language:
Python
Stars:
6
Forks:
1
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:
- Clone this repository
- Run installation script:
cd chrome-extension/scripts
windows-install.bat
- Load the extension in Chrome:
- Open
chrome://extensions/
- Enable Developer mode
- Click "Load unpacked"
- Select the
chrome-extension
directory
- Open
MacOS/Linux:
- Clone this repository
- Run installation script:
cd chrome-extension/scripts
# For MacOS:
./macos-install.sh
# For Linux:
./linux-install.sh
- Load the extension in Chrome:
- Open
chrome://extensions/
- Enable Developer mode
- Click "Load unpacked"
- Select the
chrome-extension
directory
- Open
Run Web Frontend
- Navigate to web directory:
cd web
- Install dependencies:
npm install
- Start development server:
npm run dev
- 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
- Fork the repository
- Create your feature branch:
git checkout -b feature/amazing-feature
- Commit your changes:
git commit -m 'Add amazing feature'
- Push to the branch:
git push origin feature/amazing-feature
- 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
Publisher info
Hemang Joshi
IIOT | ML/AI | ALGOTRADING
More MCP servers built with Python
An MCP (Model Context Protocol) server that provides access to Bing Webmaster Tools functionality
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.