{
  "markdown": "# McpHub\n\n<!-- mcp-name: io.github.John0King/mcphub -->\n\nMCP bridge -- folds the capabilities (tools / prompts / resources) of multiple MCP servers into **4 fixed tools**, exposed uniformly to AI tools.\n\n## Quick Start\n\n### stdio mode (default)\n\n```bash\ndotnet run --project src/McpHub -- --config examples/mcp-hub.config.json\n```\n\nConfigure in your AI tool's `mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"mcp-hub\": {\n      \"command\": \"dotnet\",\n      \"args\": [\n        \"run\",\n        \"--project\", \"path/to/McpHub\",\n        \"--\", \"--config\", \"path/to/mcp-hub.config.json\"\n      ]\n    }\n  }\n}\n```\n\n### HTTP mode\n\n```bash\ndotnet run --project src/McpHub -- --http --port 8080 --config examples/mcp-hub.config.json\n```\n\nClient connects to `http://localhost:8080/` (Streamable HTTP).\n\n## CLI Options\n\n| Option | Alias | Description | Default |\n|--------|-------|-------------|---------|\n| `--config` | `-c` | Path to the MCP configuration file | Auto-discovered |\n| `--http` | - | Use HTTP (Streamable HTTP) transport | stdio |\n| `--port` | - | HTTP mode listening port | 8080 |\n| `--workspace` | `-w` | Workspace folder for `${workspaceFolder}` substitution | Current directory |\n| `--verbose` | - | Output verbose diagnostic logs to stderr | Off |\n\n## 暴露的 3 个 Tool\n\n| Tool | 说明 |\n|------|------|\n| `list_mcp_capabilities` | 列出所有上游 MCP server 的可用能力（tools/prompts/resources），可选 `kind` 过滤 |\n| `describe_mcp_capability` | 查询某个能力的完整调用方式（参数 schema 等），输入限定名 `serverName.capabilityName` |\n| `call_mcp_capability` | 实际调用某个能力，传入限定名 + arguments |\n\n## 配置文件格式\n\n兼容 VS Code 族（`servers` 键）和 Claude/Cursor 族（`mcpServers` 键），自动推断 transport 类型：\n\n```json\n{\n  \"servers\": {\n    \"filesystem\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem\", \"/path\"],\n      \"env\": { \"API_KEY\": \"...\" }\n    },\n    \"remote-server\": {\n      \"type\": \"http\",\n      \"url\": \"https://example.com/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer xxx\" }\n    }\n  }\n}\n```\n\n支持变量替换：\n- `${workspaceFolder}` — 工作区目录\n- `${env:VAR_NAME}` — 环境变量\n\n配置文件发现顺序（未指定 `--config` 时）：\n1. `--config` 显式指定\n2. 当前目录 `mcp.json`\n3. 当前目录 `.mcp.json`\n4. `.vscode/mcp.json`\n5. `claude_desktop_config.json`\n\n## 架构\n\n```\nAI 工具  ←stdio/http→  McpHub  ←stdio/http→  多个上游 MCP Server\n                         │\n                         ├── list_mcp_capabilities  → 聚合所有 server 的 tools/prompts/resources\n                         ├── describe_mcp_capability → 透传 schema 详情\n                         └── call_mcp_capability     → 透传调用\n```\n\n详见 [设计文档](.agents/plan/mcp-hub-design.md)。\n",
  "bytes": 2531,
  "sha": "6056fb10caced8d04a5874e97707e43dc96c076f4620d459086eaac8c2057a0f",
  "repo_slug": "john0king/mcphub",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_john0king_mcphub_ee3c72a8/readme"
}