OpenAPI Slice

OpenAPI Slice MCP サーバー

特定のエンドポイントに関連する部分のみを抽出することで、大規模な OpenAPI 仕様を扱いやすくする MCP（Model Context Protocol）サーバーです。コンテキストに制限がある LLM を扱う際に特に便利です。大規模な OpenAPI 仕様全体を読み込むのではなく、特定のエンドポイントに必要な部分だけを抽出できます。

機能

• エンドポイントごとの抽出：要求されたエンドポイントとその依存関係のみを含む、最小限の OpenAPI 仕様を取得します
• 依存関係の自動解決：参照されているすべてのコンポーネント（スキーマ、パラメーターなど）を再帰的に検索して含めます
• 複数の形式：YAML または JSON 形式で出力します
• ファイルのサポート：ローカルの YAML または JSON ファイルから OpenAPI 仕様を読み込みます
• リモートのサポート：URL（HTTP/HTTPS）から OpenAPI 仕様を直接取得します
• 検出ツール：読み込んだ仕様で利用可能なエンドポイントをすべて一覧表示します

ツール

サーバーは以下の MCP ツールを提供します。

• load_openapi_spec(file_path: str) - ローカルの YAML または JSON ファイルから OpenAPI 仕様を読み込みます
• load_openapi_spec_from_url(url: str, timeout: int = 30) - リモート URL から OpenAPI 仕様を読み込みます
• list_endpoints() - 現在読み込まれている仕様で利用可能なエンドポイントをすべて一覧表示します
• extract_endpoint_slice(path: str, method: str, output_format: str = "yaml") - 特定のエンドポイントの最小限の仕様スライスを抽出します
• get_server_status() - サーバーの現在のステータスを取得します

使用方法

サーバーの実行

Stdio モード（デフォルト）

ローカル開発および Claude Desktop との連携に使用します。

uvx openapi-slice-mcp

サーバーは STDIO トランスポートを使用して実行され、任意の MCP クライアントと連携できます。

HTTP モード

Smithery へのデプロイまたはリモートアクセスに使用します。

# Using the dedicated HTTP entry point (runs on port 8000 by default)
uvx openapi-slice-mcp-http

# Or using the main entry point with --transport flag
uvx openapi-slice-mcp --transport http --host 0.0.0.0 --port 8000

HTTP サーバーは http://host:port/mcp で MCP プロトコルを公開します。