MCPHub
Provides tools for local file operations, including reading and writing UTF-8 files, listing directories, and unzipping archives.
Enables system-level interactions such as executing CLI commands, monitoring running processes, and performing disk usage analysis.
Supports querying and managing project databases through specialized PostgreSQL integration tools.
Allows for the execution of Python scripts, asynchronous script management, and package installation within the environment.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCPHubList all available MCP modules and their current status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCPHub
πΈ System Screenshots
Login Interface

Default credentials: username
admin, passwordadmin123
Module Management Interface

Manage all MCP modules with support for loading, unloading, and reloading operations
Tool Details & Control

Enable/disable each tool individually, edit tool descriptions in real-time
Proxy Server Management

Proxy existing MCP Servers without modification
Usage Statistics Dashboard

Visualize tool call counts, success rates, and response times
AI Code Generation

Generate MCP plugin code through natural language conversation
π― What is This?
MCPHub is a tool service platform based on the MCP (Model Context Protocol). It addresses a pain point in current AI Agent systems:
Each MCP Server needs to be configured separately on the client side. As the number of tools increases, configuration management becomes chaotic.
MCPHub's Solution:
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Before: Scattered Configuration β
β Claude/Cursor needs to configure dozens of MCP Server addressesβ
β - mcp-server-filesystem β
β - mcp-server-github β
β - mcp-server-postgres β
β - mcp-server-python β
β - ... (configuration explosion) β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β¬οΈ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β After: Unified Entry Point
β Claude/Cursor only needs to configure one address
β { "mcpServers": { "mcp-hub": { "url": "http://host:6081/mcp" } } }
β
β MCP Hub automatically aggregates all tools, providing:
β β
Centralized tool management
β β
Hot-pluggable enable/disable
β β
Unified monitoring and statistics
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ¨ Key Features
1οΈβ£ One Address, Infinite Tools
AI Agent clients only need to configure one MCP Server address to access all tools on the platform. Whether built-in tools, custom plugins, or proxied third-party MCP Servers, they are all transparent to clients.
2οΈβ£ Hot-Pluggable Tool Management
Module-level Management: Load, unload, and reload modules without restarting the service
Tool-level Control: Individual tools can be enabled/disabled independently
Hot Configuration Updates: Tool description changes take effect immediately without restart
3οΈβ£ Proxy Existing MCP Servers
Already have MCP Servers? No modification needed - just configure a proxy to integrate:
{
"name": "my-existing-server",
"url": "http://existing-server:8080/mcp",
"transport": "streamable-http"
}The platform automatically discovers and transparently proxies all tools from that server.
4οΈβ£ AI-Powered MCP Plugin Generation
Built-in AI code generation feature - generate compliant MCP module code through natural language conversation:
User: Help me create a weather query tool
AI: Generated t_weather module with get_current_weather and get_forecast tools...Everyone can become an MCP tool developer!
5οΈβ£ Plugin Ecosystem: Install & Share
One-click Install: Upload a ZIP package to install third-party plugins
One-click Export: Package custom plugins as ZIP to share with other users
Modular Isolation: Separate management of built-in tools (
tools/) and external plugins (tools_external/)
6οΈβ£ Group-Based Access Control
Organize modules and proxy servers into groups to control which tools different AI clients can access:
Group Isolation: Each group has its own set of modules and proxy servers
Per-Client Access: Clients specify a group via the
x-group-idHTTP header β they only see and can call tools in that groupDefault Group: All newly added modules/proxies are automatically added to the default group, ensuring backward compatibility
Flexible Assignment: A module or proxy server can belong to multiple groups simultaneously
ββββββββββββββββ ββββββββββββββββ
β Group A β β Group B β
β (Dev Tools) β β (Ops Tools) β
β β’ t_python β β β’ t_cli β
β β’ t_notebookβ β β’ t_ftp β
ββββββββββββββββ ββββββββββββββββ
β x-group-id: A β x-group-id: B
Claude Dev Agent Claude Ops Agent7οΈβ£ Comprehensive Usage Statistics
Intuitively view usage for each tool:
Call count statistics
Success rate tracking
Response time analysis
24-hour trend charts
π οΈ Built-in Tools
The platform comes with core tool modules ready to use:
Category | Module | Tools | Description |
π₯οΈ CLI Execution |
|
| Execute system commands, view processes, disk monitoring, network info |
π Python Execution |
|
| Safely execute Python scripts, install dependencies, async execution |
π€ GUI Automation |
|
| AI-driven desktop automation, automatic mouse and keyboard operations |
π Notebook |
|
| Note creation and querying, persistent storage |
Featured: AI-Driven GUI Automation
The t_autogui module implements AI-driven desktop automation:
User: Help me open the browser and visit GitHub
Agent: [Calls autogui_start_task] β AI plans task steps β Executes mouse and keyboard operationsThis is a killer feature of this platform: AI can operate the computer desktop like a human, completing complex GUI interaction tasks.
π¦ Extension Tools
Beyond built-in tools, the platform supports installing extension plugins. Currently available extension tool in tools_external/:
Category | Module | Tools | Description |
π FTP Transfer |
|
| FTP file transfer and management |
Extension tools are located in the
tools_external/directory and can be loaded on demand through the Web interface or API. You can also develop your own extension tools and install them on the platform.
π Quick Start
Requirements
Python 3.10+
(Optional) Node.js 18+ - for building the frontend
Installation
# Clone the project
git clone https://github.com/Jayden-Dong/MCPHub.git
cd MCPHub
# Create virtual environment
python -m venv .venv
source .venv/bin/activate # Linux/Mac
# .venv\Scripts\activate # Windows
# Install dependencies
pip install -r requirements.txtStart the Service
cd app
python main.pyAfter starting, access:
π Web Management Interface:
http://localhost:6080π API Documentation:
http://localhost:6080/docsπ MCP Endpoint:
http://localhost:6081/mcp
Configure MCP Client
Add the following in Claude Desktop / Cursor/Cherry Studio or other MCP clients:
{
"mcpServers": {
"general-tools": {
"url": "http://localhost:6081/mcp"
}
}
}π Done! Your AI Agent can now use all enabled tools on the platform.
π Feature Details
Module Management
Manage modules through the Web interface or API:
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Module List [Scan New Modules] [Install]
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β β
t_cli Loaded [Details] [Reload] [Unload]
β β
t_python Loaded [Details] [Reload] [Unload]
β βΈοΈ t_autogui Paused [Details] [Load]
β π¦ t_weather Not Loaded [Details] [Load] [Export]
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββTool-level Control
Enter module details to enable/disable each tool individually:
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β t_cli Module Details
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β π§ run_cli_command [β
Enabled]
β π§ list_directory [β
Enabled]
β π§ get_system_info [β Disabled]
β π§ kill_process [β Disabled] β οΈ Dangerous
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββProxy MCP Server
Connect existing MCP Servers to the platform:
Via Web Interface:
Navigate to the "Proxy Management" page
Click "Add Server"
Fill in server name, URL, and transport type
Click "Sync Tools" β Tools automatically appear in the platform
Via API:
curl -X POST http://localhost:6080/api/proxy/servers \
-H "Content-Type: application/json" \
-d '{
"name": "filesystem-server",
"url": "http://localhost:3000/mcp",
"transport": "streamable-http"
}'AI Code Generation
Generate MCP plugins through conversation:
# Start conversation
curl -X POST http://localhost:6080/api/codegen/chat \
-H "Content-Type: application/json" \
-d '{"message": "Help me create a stock query tool that supports real-time prices and historical trends"}'
# Preview generated code
curl http://localhost:6080/api/codegen/preview/{task_id}
# Install directly to platform
curl -X POST http://localhost:6080/api/codegen/install/{task_id}Group Management
Groups allow you to organize modules and proxy servers and control which tools each AI client can access.
Via Web Interface:
Navigate to the "Group Management" page
Click "Create Group" and give it a name
Add modules or proxy servers to the group
Copy the group ID and pass it to the client via the
x-group-idheader
Via API:
# Create a group
curl -X POST http://localhost:6080/api/groups \
-H "Content-Type: application/json" \
-d '{"name": "dev-tools", "description": "Tools for development"}'
# Add a module to the group
curl -X POST http://localhost:6080/api/groups/{group_id}/modules \
-H "Content-Type: application/json" \
-d '{"module_name": "t_python"}'Configuring the MCP Client with a Group:
{
"mcpServers": {
"dev-tools": {
"url": "http://localhost:6081/mcp",
"headers": {
"x-group-id": "<your-group-id>"
}
}
}
}When a client provides an x-group-id header, it can only list and call tools that belong to that group. Clients without a group header can access all enabled tools.
Usage Statistics
View tool call information:
# Overall overview
curl http://localhost:6080/api/stats/overview
# Statistics by tool
curl http://localhost:6080/api/stats/tools
# Recent call records
curl http://localhost:6080/api/stats/recent?limit=100Response example:
{
"total_calls": 1523,
"success_rate": 0.98,
"top_tools": [
{"name": "run_python_script", "calls": 456, "avg_duration_ms": 1234},
{"name": "run_cli_command", "calls": 312, "avg_duration_ms": 567}
]
}π API Documentation
Module Management /api/modules
Method | Path | Description |
GET |
| Get all module list |
GET |
| Scan unloaded modules |
POST |
| Load module |
POST |
| Unload module |
POST |
| Reload module |
POST |
| Enable tool |
POST |
| Disable tool |
POST |
| Install ZIP plugin |
GET |
| Export module as ZIP |
DELETE |
| Delete external module |
Proxy Management /api/proxy
Method | Path | Description |
GET |
| Get proxy server list |
POST |
| Add proxy server |
PUT |
| Update configuration |
DELETE |
| Delete server |
POST |
| Sync tool list |
POST |
| Enable server |
POST |
| Disable server |
Group Management /api/groups
Method | Path | Description |
GET |
| Get all groups |
POST |
| Create a group |
GET |
| Get group details |
PUT |
| Update group info |
DELETE |
| Delete group |
GET |
| Get all members (modules + proxies) |
POST |
| Add module to group |
DELETE |
| Remove module from group |
POST |
| Add proxy server to group |
DELETE |
| Remove proxy from group |
GET |
| Get groups containing a module |
GET |
| Get groups containing a proxy |
Statistics Query /api/stats
Method | Path | Description |
GET |
| Overall statistics overview |
GET |
| Statistics by module |
GET |
| Statistics by tool |
GET |
| Recent call records |
AI Code Generation /api/codegen
Method | Path | Description |
POST |
| Conversational code generation |
POST |
| Streaming conversation |
GET |
| Preview generated code |
POST |
| Install to platform |
POST |
| Download ZIP |
π§© Development Guide
Creating Custom Modules
For detailed module development specifications, please refer to MCP_MODULE_DEV_GUIDE.md.
Quick Start:
my_module/
βββ __init__.py # Package marker
βββ MODULE_INFO # Module metadata
βββ my_module_mcp.py # MCP tool registration
βββ my_module_tool.py # Business logic
βββ requirements.txt # Optional dependenciesMODULE_INFO:
{
"display_name": "My Tool",
"version": "1.0.0",
"description": "Tool description",
"author": "Your Name"
}my_module_mcp.py:
from mcp_service import mcp
from config_py.config import settings
from config_py.prompt import prompt_manager
from utils import com_utils
from utils.com_utils import get_mcp_exposed_url
TOOL_NAME = "my_tool"
@mcp.tool(
name=f'{settings.MCP_TOOL_NAME_PREFIX}{TOOL_NAME}',
description=f'MCP Server URL: {get_mcp_exposed_url()}. {prompt_manager.get(TOOL_NAME)}',
enabled=com_utils.get_tool_enable(TOOL_NAME),
)
def my_tool(param: str) -> dict:
"""Tool description"""
return {"success": True, "data": "result"}Package & Share
# Package
zip -r my_module.zip my_module/
# Install
curl -X POST http://localhost:6080/api/modules/install \
-F "file=@my_module.zip"ποΈ System Architecture
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β MCP Client (Claude / Cursor) β
βββββββββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββ
β MCP Protocol (HTTP Streamable)
βΌ :6081
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β MCP Service (FastMCP)
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β β Middleware Layer
β β β’ RequestMCPMiddleware (logging/statistics)
β β β’ ToolDescriptionCheckerMiddleware (description hot update)
β β β’ ToolEnabledCheckerMiddleware (tool filtering)
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β βββββββββββββββ βββββββββββββββ βββββββββββββββ
β β Built-in β β External β β Proxy β
β β Tools β β Plugins β β Tools β
β β tools/ β β external/ β β proxy/ β
β βββββββββββββββ βββββββββββββββ βββββββββββββββ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β REST API (FastAPI) :6080 β
β /api/modules /api/stats /api/proxy /api/codegen /api/auth β
βββββββββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββ
β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Web Frontend (Vue 3) β
β Module Management | Tool Control | Proxy Config | Statistics β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Data Layer (SQLite) β
β Module Status | Tool Config | Call Statistics | Proxy Config β
β User Authentication β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββπ Project Structure
MCPHub/
βββ requirements.txt # Python dependencies
βββ README.md # This file
βββ MCP_MODULE_DEV_GUIDE.md # Module development guide
βββ config/
β βββ config.json # Main configuration file
β βββ mcp_hub.db # SQLite database
βββ app/
βββ main.py # FastAPI entry point
βββ mcp_service.py # MCP service initialization
βββ my_mcp_middleware.py # MCP middleware
βββ config_py/ # Configuration management
βββ managers/ # Core managers
β βββ module_manager.py # Module lifecycle
β βββ proxy_manager.py # Proxy servers
β βββ stats_manager.py # Statistics management
βββ api/ # REST API
βββ tools/ # Built-in modules
β βββ t_autogui/ # GUI automation
β βββ t_cli/ # CLI commands
β βββ t_python/ # Python execution
β βββ ...
βββ tools_external/ # External plugins
βββ toolsmcp/ # MCP tool wrappers
βββ web/ # Vue 3 frontendβοΈ Configuration
Main configuration file: config/config.json
{
"api": {
"title": "MCPHub Service",
"version": "1.0.0"
},
"server": {
"host": "0.0.0.0",
"port": 6080
},
"mcp": {
"service_name": "mcphub",
"host": "0.0.0.0",
"port": 6081,
"path": "/mcp",
"tool_name_prefix": "",
"module_enable": [
{
"enable": true,
"module_name": "tools.t_cli.cli_mcp",
"disable_tool": [],
"config": {}
}
]
},
"database": {
"db_path": "./config/mcp_hub.db"
},
"auth": {
"secret_key": "your-secret-key",
"token_expire_hours": 24
}
}Configuration | Description |
| Tool name prefix for distinguishing multi-instance deployments |
| List of modules to auto-load on startup |
| List of disabled tool names in the module |
| Custom configuration passed to the module |
π€ Contributing
Contributions, bug reports, and suggestions are welcome!
Fork this repository
Create a 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)Create a Pull Request
π License
This project is licensed under the MIT License.
π Acknowledgments
FastMCP - Framework for quickly building MCP Servers
MCP Protocol - Model Context Protocol specification
FastAPI - Modern high-performance Python web framework
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Jayden-Dong/MCPHub'
If you have feedback or need assistance with the MCP directory API, please join our Discord server