MCP Gateway (Parent MCP Server)
複数の子MCPサーバーを一元管理し、スキーマ取得やツール実行を肩代わりするゲートウェイです。
概要
children_config.(json|toml)に定義した子サーバーを起動し、常駐セッション+lockで衝突を防ぎながらツールを呼び出します。- 子サーバーのスキーマ取得(
get_schema)や任意ツール呼び出し(execute_child_tool)を1つのインターフェースで提供します。 children_abstract.jsonがあれば、子サーバー概要をリソースとして返します。
子サーバー例(同梱テンプレート)
children_config.example.json/children_config.example.toml では以下を登録しています。children_abstract.example.json と合わせて参考にしてください。
serena: コードベースのシンボリック検索/編集、メモ管理、限定的なシェル実行(tools: read_file, find_file, find_symbol, replace_content, execute_shell_command など)context7: ライブラリ名→Context7互換ID解決とドキュメント取得(resolve-library-id, get-library-docs)codegraph: コードグラフ検索、依存/呼び出し探索、ファイル読取り、GraphRAG検索、再インデックス(query_codebase, read_file_content, reindex_repository など)
セットアップ
- 依存関係インストール
uv sync - 設定ファイルを作成(テンプレートをコピー)
# JSONで使う場合 cp children_config.example.json children_config.json # codex CLIなどTOML形式を使う場合 cp children_config.example.toml children_config.toml cp children_abstract.example.json children_abstract.jsonchildren_config.jsonまたはchildren_config.toml内で各子サーバーのコマンド/引数/環境変数を環境に合わせて修正してください。
起動方法
ローカル実行(リポジトリclone済み)
uv run mcp-gateway \
--children-config /absolute/path/to/children_config.json \
--children-abstract /absolute/path/to/children_abstract.json
uvx経由(GitHub公開後)
uvx --from git+https://github.com/OWNER/MCPgateway \
mcp-gateway \
--children-config /absolute/path/to/children_config.json \
--children-abstract /absolute/path/to/children_abstract.json
※ OWNER/リポジトリ名は実際のものに置き換えてください。
codex CLIなどTOML設定で渡す場合
uv run mcp-gateway \
--children-config /absolute/path/to/children_config.toml \
--children-abstract /absolute/path/to/children_abstract.json
他プロジェクトから使う例(.mcp.json)
{
"mcpServers": {
"mcp-gateway": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/OWNER/MCPgateway",
"mcp-gateway",
"--children-config",
"/absolute/path/to/children_config.json",
"--children-abstract",
"/absolute/path/to/children_abstract.json"
],
"env": { "PYTHONUTF8": "1" }
}
}
}
--children-config には .json / .toml のどちらも指定できます。
親サーバーが提供する主なツール
list_registered_children()登録済み子サーバー名の一覧get_child_status()子サーバーの起動状態/エラー情報get_schema(child_name)子サーバーのツール・リソースのスキーマ取得(常駐セッション経由)execute_child_tool(child_name, tool_name, tool_args, head_chars=None, tail_chars=None)子サーバーツールの実行(長文はhead/tailで省略可能)close_child_session(child_name)セッションを明示的に停止- Resources:
mcp://server_summary,mcp://children_servers(abstract提供時)
使い方のヒント
- スキーマ確認:
get_schema("serena"),get_schema("codegraph")等でツール一覧を取得できます。 - ツール実行: 例)
execute_child_tool("serena", "find_file", {"file_mask": "*.py", "relative_path": "."}) - codegraphで再インデックスが必要な場合は
execute_child_tool("codegraph", "reindex_repository", {"incremental": true})を実行してください。
プロジェクト構造
MCPgateway/
├── mcp_gateway_server.py # 親MCPサーバー本体(FastMCPベース)
├── children_config.example.json # 子サーバー設定テンプレート
├── children_config.example.toml # 子サーバー設定テンプレート(TOML版)
├── children_abstract.example.json# 子サーバー概要テンプレート
├── children_config.json # 実運用用(ユーザー作成)
├── children_config.toml # 実運用用(TOMLで使う場合)
├── example.mcp.json # .mcp.json設定例
├── pyproject.toml # パッケージ定義・エントリポイント(mcp-gateway)
└── README.md
トラブルシューティング
- Python環境が見つからない場合:
uv syncを実行して仮想環境を作成してください。 - 子サーバーが起動しない場合:
children_config.json/children_config.tomlのコマンド/パス/環境変数を確認- npx/uvx など依存コマンドが使えるか確認
- 子サーバー側の依存をインストール
- 子サーバーのstderrを確認したい場合:
DEBUG_MCP=1を設定して起動するとstderrを出力します。
