Mcphub

0 forks

4 stars

Free

What is mcphub

mcphub is a versatile tool created by hemangjoshi37a designed to streamline the management of Model Context Protocol (MCP) servers. Think of mcphub as a modern package manager, similar to apt or pip, but specifically tailored for MCP servers. It combines the convenience of a web interface with the robustness of a Chrome extension to facilitate secure, local system operations. MCP servers act as intermediaries, allowing AI systems to access and interact with various data sources, tools, and prompts while maintaining security and efficiency.

How to Use mcphub

Using mcphub involves setting up a Chrome extension and running a web-based frontend. Follow these steps to get started:

Installation

For Windows:

Clone the mcphub repository.
Execute the installation script by navigating to chrome-extension/scripts and running windows-install.bat.
Load the extension in Chrome by enabling Developer mode in chrome://extensions/ and selecting "Load unpacked" to choose the chrome-extension directory.

For MacOS/Linux:

Clone the mcphub repository.
Run the corresponding installation script (macos-install.sh or linux-install.sh) from chrome-extension/scripts.
Load the extension in Chrome by enabling Developer mode in chrome://extensions/ and selecting "Load unpacked" to choose the chrome-extension directory.

Running the Web Frontend

Navigate to the web directory.
Install dependencies using npm install.
Start the development server with npm run dev.
Open the application in Chrome at http://localhost:3000.

Key Features of mcphub

MCP Server Management: Browse, install, and manage MCP servers effortlessly.
Server Configuration: Easily handle server configurations and environment variables.
Secure Operations: Utilize a Chrome extension for secure local system integrations.
Web-Based Interface: Manage everything through an intuitive web interface, making it accessible and user-friendly.
Real-Time Monitoring: Keep track of server status and operations in real time.
Cross-Platform Support: Available on Windows, MacOS, and Linux, ensuring broad usability.
Claude Desktop Integration: Seamlessly integrates with Claude Desktop configurations, allowing for streamlined management of AI system contexts.
Open Source: Embraces the open-source ethos, encouraging contributions and community-driven improvements.

mcphub simplifies the complex task of managing MCP servers, making it accessible to both technical and non-technical users. Its combination of web-based management and secure local operations provides a comprehensive solution for interacting with AI systems and data sources securely. Whether you're an AI developer or someone looking to enhance their AI system's capabilities, mcphub offers a powerful toolset to manage and monitor your MCP servers effectively.

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:

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 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

Run Web Frontend

Navigate to web directory:

cd web

Install dependencies:

npm install

Start development server:

npm run dev

Open 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 file for details.

🔗 Links

Documentation
Issue Tracker
Model Context Protocol Made with ❤️ by the MCPHub community

How to Use

To use the mcphub, follow these steps:

Visit https://github.com/hemangjoshi37a/mcphub
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using mcphub capabilities within your Claude conversations

Additional Information

Created

December 21, 2024

Company

hemangjoshi37a

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More