┌─────────────────────────────────────────────────────────────────┐
│                    之前：分散配置                                
│  Claude/Cursor 需要配置数十个 MCP Server 地址                    
│  - mcp-server-filesystem                                        
│  - mcp-server-github                                            
│  - mcp-server-postgres                                          
│  - mcp-server-python                                            
│  - ... (配置爆炸)                                                
└─────────────────────────────────────────────────────────────────┘
                              ⬇️
┌─────────────────────────────────────────────────────────────────────────┐
│                    之后：统一入口                                
│  Claude/Cursor 只需配置一个地址                                 
│  { "mcpServers": { "mcp-hub": { "url": "http://host:9000/mcp" } } } 
│                                                                 
│  MCP Hub 自动聚合所有工具，实现：                                
│  ✅ 集中式工具管理                                               
│  ✅ 热插拔启用/禁用                                              
│  ✅ 统一监控统计                                                 
└─────────────────────────────────────────────────────────────────────────┘

{
  "name": "my-existing-server",
  "url": "http://existing-server:8080/mcp",
  "transport": "streamable-http"
}

用户: 帮我创建一个天气查询工具
AI: 已生成 t_weather 模块，包含 get_current_weather 和 get_forecast 两个工具...

用户: 帮我打开浏览器并访问 GitHub
Agent: [调用 autogui_start_task] → AI 规划任务步骤 → 执行鼠标键盘操作

# 克隆项目
git clone https://github.com/your-username/MCPHub.git
cd MCPHub

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# .venv\Scripts\activate   # Windows

# 安装依赖
pip install -r requirements.txt

cd app
python main.py

{
  "mcpServers": {
    "general-tools": {
      "url": "http://localhost:9000/mcp"
    }
  }
}

┌─────────────────────────────────────────────────────────┐
│  模块列表                    [扫描新模块] [安装模块]      
├─────────────────────────────────────────────────────────┤
│  ✅ t_cli        已加载    [详情] [重载] [卸载]          
│  ✅ t_python     已加载    [详情] [重载] [卸载]          
│  ⏸️ t_autogui    已暂停    [详情] [加载]                
│  📦 t_weather    未加载    [详情] [加载]    [导出] [删除]
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│  t_cli 模块详情                                          
├─────────────────────────────────────────────────────────┤
│  🔧 run_cli_command      [✅ 启用]                      
│  🔧 list_directory       [✅ 启用]                      
│  🔧 get_system_info      [❌ 禁用]                      
│  🔧 kill_process         [❌ 禁用]  ⚠️ 危险操作         
└─────────────────────────────────────────────────────────┘

curl -X POST http://localhost:8000/api/proxy/servers \
  -H "Content-Type: application/json" \
  -d '{
    "name": "filesystem-server",
    "url": "http://localhost:3000/mcp",
    "transport": "streamable-http"
  }'

# 开始对话
curl -X POST http://localhost:8000/api/codegen/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "帮我创建一个股票查询工具，支持查询实时价格和历史走势"}'

# 预览生成的代码
curl http://localhost:8000/api/codegen/preview/{task_id}

# 直接安装到平台
curl -X POST http://localhost:8000/api/codegen/install/{task_id}

# 整体概览
curl http://localhost:8000/api/stats/overview

# 按工具统计
curl http://localhost:8000/api/stats/tools

# 最近调用记录
curl http://localhost:8000/api/stats/recent?limit=100

{
  "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}
  ]
}

my_module/
├── __init__.py          # 包标记
├── MODULE_INFO          # 模块元信息
├── my_module_mcp.py     # MCP 工具注册
├── my_module_tool.py    # 业务逻辑
└── requirements.txt     # 可选依赖

{
  "display_name": "我的工具",
  "version": "1.0.0",
  "description": "工具描述",
  "author": "Your Name"
}

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:
    """工具说明"""
    return {"success": True, "data": "result"}

# 打包
zip -r my_module.zip my_module/

# 安装
curl -X POST http://localhost:8000/api/modules/install \
  -F "file=@my_module.zip"

┌─────────────────────────────────────────────────────────────────┐
│                    MCP 客户端 (Claude / Cursor)                  
└───────────────────────────────┬─────────────────────────────────┘
                                │ MCP Protocol (HTTP Streamable)
                                ▼ :9000
┌─────────────────────────────────────────────────────────────────┐
│                    MCP Service (FastMCP)                        
│  ┌───────────────────────────────────────────────────────────┐  
│  │  中间件层                                                   
│  │  • RequestMCPMiddleware (日志记录/统计)                    
│  │  • ToolDescriptionCheckerMiddleware (描述热更新)           
│  │  • ToolEnabledCheckerMiddleware (工具过滤)                 
│  └───────────────────────────────────────────────────────────┘ 
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐             
│  │  内置工具    │  │  外部插件    │  │  代理工具    │             
│  │  tools/     │  │  external/  │  │  proxy/     │             
│  └─────────────┘  └─────────────┘  └─────────────┘             
└─────────────────────────────────────────────────────────────────┘
                                │
┌─────────────────────────────────────────────────────────────────┐
│                    REST API (FastAPI) :8000                     
│  /api/modules  /api/stats  /api/proxy  /api/codegen  /api/auth 
└───────────────────────────────┬─────────────────────────────────┘
                                │
┌─────────────────────────────────────────────────────────────────┐
│                    Web 前端 (Vue 3)                            
│  模块管理 | 工具控制 | 代理配置 | 统计看板 | AI 生成             
└─────────────────────────────────────────────────────────────────┘
                                │
┌─────────────────────────────────────────────────────────────────┐
│                    数据层 (SQLite)                              
│  模块状态 | 工具配置 | 调用统计 | 代理配置 | 用户认证            
└─────────────────────────────────────────────────────────────────┘

MCPHub/
├── requirements.txt              # Python 依赖
├── README.md                     # 本文件
├── MCP_MODULE_DEV_GUIDE.md       # 模块开发指南
├── config/
│   ├── config.json               # 主配置文件
│   └── mcp_hub.db               # SQLite 数据库
└── app/
    ├── main.py                   # FastAPI 入口
    ├── mcp_service.py            # MCP 服务初始化
    ├── my_mcp_middleware.py      # MCP 中间件
    ├── config_py/                # 配置管理
    ├── managers/                 # 核心管理器
    │   ├── module_manager.py     # 模块生命周期
    │   ├── proxy_manager.py      # 代理服务器
    │   └── stats_manager.py      # 统计管理
    ├── api/                      # REST API
    ├── tools/                    # 内置模块
    │   ├── t_autogui/            # GUI 自动化
    │   ├── t_cli/                # CLI 命令
    │   ├── t_python/             # Python 执行
    │   └── ...
    ├── tools_external/           # 外部插件
    ├── toolsmcp/                 # MCP 工具封装
    └── web/                      # Vue 3 前端

{
  "api": {
    "title": "MCPHub Service",
    "version": "1.0.0"
  },
  "server": {
    "host": "0.0.0.0",
    "port": 8000
  },
  "mcp": {
    "service_name": "mcphub",
    "host": "0.0.0.0",
    "port": 9000,
    "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
  }
}