McpHub

McpHub

MCP ブリッジ — 複数の MCP サーバーの機能（ツール／プロンプト／リソース）を 4 つの固定ツールに統合し、AI ツールに一律に公開します。

クイックスタート

stdio モード（デフォルト）

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

AI ツールの mcp.json で設定します。

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

HTTP モード

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

クライアントは http://localhost:8080/ に接続します（ストリーミング可能な HTTP）。

CLI オプション

オプション	別名	説明	デフォルト
--config	-c	MCP 設定ファイルのパス	自動検出
--http	-	HTTP（ストリーミング可能な HTTP）トランスポートを使用します	stdio
--port	-	HTTP モードのリスニングポート	8080
--workspace	-w	${workspaceFolder} の置換に使用するワークスペースフォルダー	現在のディレクトリ
--verbose	-	詳細な診断ログを stderr に出力します	オフ

公開される 3 つのツール

ツール	説明
list_mcp_capabilities	すべての上流 MCP サーバーで利用可能な機能（ツール／プロンプト／リソース）を一覧表示します。kind で絞り込むこともできます
describe_mcp_capability	機能の完全な呼び出し方法（パラメーターのスキーマなど）を照会します。入力は限定名 serverName.capabilityName です
call_mcp_capability	限定名と arguments を渡して、機能を実際に呼び出します

設定ファイルの形式

VS Code 系（servers キー）と Claude／Cursor 系（mcpServers キー）に対応し、トランスポートの種類を自動的に推測します。

{
  "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. claude_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     → 透传调用

詳細は設計ドキュメントを参照してください。