transparent-openapi-mcp

OpenAPI v3 の仕様を MCP ツールに 1:1 で透過的にマッピングする KISS な MCP サーバーです。読み込んだ OpenAPI 仕様が変更されても、このサーバー自身のコードを変更する必要は一切ありません。

Claude Code の MCP サーバーとして使用する

手順は3つです。イメージをビルドし、サーバー側の設定を整え、Claude Code に組み込みます。

1. ビルド

./podman_build.sh

2. サーバーを設定する

サーバーには専用の設定が必要です。コンテナにマウントされたローカルファイルが設定リストを指し、その設定リストがあなたの OpenAPI 仕様とバックエンドを指す構成です。各ファイルの内容、<prefix>_<operationId> のツール命名規則、エンドツーエンドでの動作が確認済みの実行可能なサンプル一式など、完全なリファレンスは examples/README.md を参照してください。

3. Claude Code に組み込む

Claude Code は、コンテナを stdio サブプロセスとして起動する方法を知っている必要があります。追加すべき MCP 設定エントリの正確な内容と、手順 2 のサーバー側設定との関係は、examples/claude-code/README.md を参照してください。

追加後、.Claude Code セッションで /mcp を実行し、transparent-openapi-mcp がそのツールとともに表示されることを確認してください。

Related MCP server: ControlAPI-MCP

同梱のサンプルで試す

実際の仕様/バックエンドを組み込む前に、同梱の最小限のサンプルで一連の流れが機能することを確認できます。

./podman_build.sh

mkdir -p ~/t-o-m-config
cp examples/*.example.json ~/t-o-m-config/
cd ~/t-o-m-config
mv local-config.example.json local-config.json
mv config-list.example.json config-list.json
mv minimal-openapi.example.json minimal-openapi.json

# in another terminal, serve that directory:
cd ~/t-o-m-config && python3 -m http.server 8000

# back in the first terminal:
./podman_run.sh ~/t-o-m-config/local-config.json

ツールを実際に呼び出して結果を確認する方法を含む完全な手順は examples/README.md を参照してください (これは単にサーバーを起動するだけです。サーバーは stdio 上で静かに待機しますが、これが正しい MCP の動作です)。

設計ドキュメント

完全な要件一式 (R-CTRL、R-DEPLOY、R-CFG、R-BOOT、R-TOOLS、R-FWD、R-STACK、R-RELEASE) と設計については、docs/core-mcp-server/requirements.md と docs/core-mcp-server/architecture.md を参照してください。