About McpHub
McpHub is an MCP bridge for AI tools that consolidates capabilities from multiple upstream MCP servers behind a small, fixed tool set. It supports stdio and Streamable HTTP transports and common MCP configuration layouts.
Key features
- 01Aggregates tools, prompts, and resources
- 02Lists and filters server capabilities
- 03Describes capability schemas
- 04Calls upstream capabilities
- 05stdio and Streamable HTTP transports
Use cases
- 01Expose several MCP servers through one connection
- 02Inspect an upstream capability before calling it
- 03Call tools or access prompts and resources across servers
MCP support
McpHub connects to multiple upstream MCP servers and exposes their tools, prompts, and resources to MCP clients through fixed tools for listing, describing, and calling capabilities.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEMcpHub
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
| Option | Alias | Description | Default |
|---|---|---|---|
--config | -c | Path to the MCP configuration file | Auto-discovered |
--http | - | Use HTTP (Streamable HTTP) transport | stdio |
--port | - | HTTP mode listening port | 8080 |
--workspace | -w | Workspace folder for ${workspaceFolder} substitution | Current directory |
--verbose | - | Output verbose diagnostic logs to stderr | Off |
暴露的 3 个 Tool
| Tool | 说明 |
|---|---|
list_mcp_capabilities | 列出所有上游 MCP server 的可用能力（tools/prompts/resources），可选 kind 过滤 |
describe_mcp_capability | 查询某个能力的完整调用方式（参数 schema 等），输入限定名 serverName.capabilityName |
call_mcp_capability | 实际调用某个能力，传入限定名 + arguments |
配置文件格式
兼容 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 时）：
--config显式指定- 当前目录
mcp.json - 当前目录
.mcp.json .vscode/mcp.jsonclaude_desktop_config.json
架构
AI 工具 ←stdio/http→ McpHub ←stdio/http→ 多个上游 MCP Server
│
├── list_mcp_capabilities → 聚合所有 server 的 tools/prompts/resources
├── describe_mcp_capability → 透传 schema 详情
└── call_mcp_capability → 透传调用
详见 设计文档。
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.