Openapi MCP Server 3wh

🚀 OpenAPI MCP サーバー

このプロジェクトは、独自のMCPサーバーを構築する際の起点として利用できるサンプルです。このサンプルの加法関数は、3種類のプロトコルすべてでハンドラーを実装する方法を示しています。

✨ 主な機能

現在の実装状況：

• ✅ 標準入出力（stdio）
• ✅ Server-Sent Events（SSE）
• ✅ OpenAPI/REST エンドポイント

🚀 クイックスタート

サーバーは MODE 環境変数によって制御される3種類の異なる実行モードをサポートしています。

• stdio：標準I/Oサーバーとして実行
• sse：Server-Sent Eventsサーバーとして実行（ポート8001）
• openapi：OpenAPI/RESTサーバーとして実行（ポート8002）

📦 インストール

Docker Composeを使用する場合

1. コンテナをビルドします。

docker compose build

2. 特定のサービスを実行します。

# すべてのサービスを同時に実行
docker compose up

# SSEサーバーのみを実行
docker compose up sse-mcp-server

# OpenAPIサーバーのみを実行
docker compose up openapi-mcp-server

直接Dockerを使用する場合

以下のコマンドで、サーバーを直接Dockerで実行することもできます。

# stdioモードで実行
docker run -i --rm -e MODE=stdio 3loc/openapi-mcp-server

# SSEモードで実行
docker run -p 8001:8000 --rm -e MODE=sse 3loc/openapi-mcp-server

# OpenAPIモードで実行
docker run -p 8002:8000 --rm -e MODE=openapi 3loc/openapi-mcp-server

📚 ドキュメント

設定

サーバーは mcp.json ファイルを使用して設定することができます。以下は設定例です。

{
  "mcpServers": {
    "stdio-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm", 
        "-i",
        "--name", "openapi-mcp-server",
        "-e", "MODE=stdio",
        "3loc/openapi-mcp-server"
      ]
    },
    "sse-mcp-server": {
      "url": "http://localhost:8001/sse"
    }
  }
}

開発

このプロジェクトは、複数の通信プロトコルを持つMCPサーバーを実装するための基礎を提供しています。すべての3つのモード（stdio、SSE、OpenAPI）が実装されており、必要に応じて使い分けることができます。