McpHub MCP server

McpHub

<!-- mcp-name: io.github.John0King/mcphub -->

MCP bridge -- folds the capabilities (tools / prompts / resources) of multiple MCP servers into 4 fixed tools, exposed uniformly to AI tools.

Quick Start

stdio mode (default)

dotnet run --project src/McpHub -- --config examples/mcp-hub.config.json

Configure in your AI tool's mcp.json:

{
  "servers": {
    "mcp-hub": {
      "command": "dotnet",
      "args": [
        "run",
        "--project", "path/to/McpHub",
        "--", "--config", "path/to/mcp-hub.config.json"
      ]
    }
  }
}

HTTP mode

dotnet run --project src/McpHub -- --http --port 8080 --config examples/mcp-hub.config.json

Client connects to http://localhost:8080/ (Streamable HTTP).

CLI Options

暴露的 3 个 Tool

配置文件格式

兼容 VS Code 族（servers 键）和 Claude/Cursor 族（mcpServers 键），自动推断 transport 类型：

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"],
      "env": { "API_KEY": "..." }
    },
    "remote-server": {
      "type": "http",
      "url": "https://example.com/mcp",
      "headers": { "Authorization": "Bearer xxx" }
    }
  }
}

支持变量替换：

• ${workspaceFolder} — 工作区目录
• ${env:VAR_NAME} — 环境变量

配置文件发现顺序（未指定 --config 时）：

1. --config 显式指定
2. 当前目录 mcp.json
3. 当前目录 .mcp.json
4. .vscode/mcp.json
5. claudedesktopconfig.json

架构

AI 工具  ←stdio/http→  McpHub  ←stdio/http→  多个上游 MCP Server
                         │
                         ├── list_mcp_capabilities  → 聚合所有 server 的 tools/prompts/resources
                         ├── describe_mcp_capability → 透传 schema 详情
                         └── call_mcp_capability     → 透传调用

详见 设计文档。