/ ディレクトリ / プレイグラウンド / mcpo (MCP-to-OpenAPI)
← 全サーバー ↗ GitHub
● コミュニティ open-webui ⚡ 即起動

mcpo (MCP-to-OpenAPI)

作者 open-webui · open-webui/mcpo

任意のMCPサーバーをOpenAPIでラップ — 即座に/docs・リクエスト/レスポンススキーマ・OAuthが使えるようになり、HTTPクライアント（またはMCPを話さないモデル）から呼び出せます。

mcpoはOpen WebUIチームが作った小さなFastAPIシムで、任意のstdio MCPサーバーを標準のOpenAPI HTTPサービスに変換します。MCPコマンド（mcpo -- uvx mcp-server-time）をラップするだけで、すぐに/openapi.json・/docs（Swagger）・すべてのツールのJSON Schema・OAuthサポートが得られます。MCPサーバー側を変更することなく、非MCPクライアント（curl・Postman・OpenAI function-calling・社内サービス）からアクセス可能にしたい場合に便利です。

▶ デモを見る 📦 インストール 💡 ユースケース

なぜ使うのか

主な機能

ライブデモ

実際の動作

mcpo-openapi-mcp.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcpo-openapi-mcp": {
      "command": "uvx",
      "args": [
        "mcpo",
        "--",
        "uvx",
        "mcp-server-time"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcpo-openapi-mcp": {
      "command": "uvx",
      "args": [
        "mcpo",
        "--",
        "uvx",
        "mcp-server-time"
      ]
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcpo-openapi-mcp": {
      "command": "uvx",
      "args": [
        "mcpo",
        "--",
        "uvx",
        "mcp-server-time"
      ]
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcpo-openapi-mcp": {
      "command": "uvx",
      "args": [
        "mcpo",
        "--",
        "uvx",
        "mcp-server-time"
      ]
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcpo-openapi-mcp",
      "command": "uvx",
      "args": [
        "mcpo",
        "--",
        "uvx",
        "mcp-server-time"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "mcpo-openapi-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "mcpo",
          "--",
          "uvx",
          "mcp-server-time"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add mcpo-openapi-mcp -- uvx mcpo -- uvx mcp-server-time

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： mcpo (MCP-to-OpenAPI)

curl / Postman / OpenAI function-callingからMCPサーバーを呼び出す方法

👤 ランタイムがMCPをまだ話さないバックエンド開発者 ⏱ ~15 min intermediate

使うタイミング： 優れたMCPサーバーを選んだが、本番スタックがPythonサービス / OpenAI Assistants API / HTTP+JSONを必要とするものの場合。

前提条件
  • 通常起動するMCPコマンド — 例：uvx mcp-server-timeまたはnpx -y @modelcontextprotocol/server-fetch
フロー
  1. ラップする
    Run uvx mcpo --port 8000 -- uvx mcp-server-time and confirm /docs is up.✓ コピーしました
    → Swagger UIがツールをエンドポイントとして表示
  2. curlから呼び出す
    Show me a working curl that calls the time tool with timezone=America/Los_Angeles.✓ コピーしました
    → 現在時刻 + タイムゾーン情報が返される
  3. OpenAIに接続する
    Generate a function-calling spec from /openapi.json that I can paste into the OpenAI API.✓ コピーしました
    → スペックが出力；簡単なテスト呼び出しが成功

結果： 非MCPバックエンドがHTTP経由で操作できるMCPサーバー。

注意点
  • 長時間実行ツールがデフォルトのuvicorn設定でタイムアウトする — mcpoに--timeout-keep-alive 600を渡すか、同じタイムアウトでnginxをフロントに置いてください

複数のMCPを1つのHTTPサービスの背後で実行する

👤 多数のMCPを統合するプラットフォームエンジニア ⏱ ~30 min intermediate

使うタイミング： time・fetch・filesystemのMCPをそれぞれ独自のパスプレフィックスで1つのURLにホストしたい場合。

フロー
  1. 組み合わせる
    Write the mcpo config for 3 servers — time at /time, fetch at /fetch, filesystem at /fs.✓ コピーしました
    → 3サービスを持つconfig.yaml；mcpoがサービスを提供
  2. OAuthを追加する
    Configure JWT auth via the issuer of my Auth0 tenant. Endpoints require a valid token.✓ コピーしました
    → tokenなしの呼び出しが401を返す

結果： 多数のMCPをホストする単一の安全なHTTPエントリーポイント。

注意点
  • 2つのサーバーが同じ名前のツールを公開するとき衝突する — mcpoはプレフィックスで名前空間を区切ります；ツールの競合はURLパスで解決されます

HTTP統合テストスイートの一部としてMCPを使用する

👤 QA / SDETチーム ⏱ ~25 min advanced

使うタイミング： 標準のHTTPテストツールでMCPサーバーの動作をアサートしたい場合。

フロー
  1. CIで起動する
    Add a GitHub Actions job that runs mcpo wrapping our MCP, then runs Playwright/pytest against it.✓ コピーしました
    → ワークフローファイルが書き込まれ；ローカルでパス
  2. スキーマアサーション
    Snapshot /openapi.json. Fail the build if the schema changes without an explicit change in the source.✓ コピーしました
    → CIにスキーマ差分ガードが追加

結果： MCPサーバーに適用された標準HTTPテストパイプライン。

注意点
  • 基盤MCPが起動時に重い依存関係をインポートするとフレイキーになる — テスト実行前に/healthzの待機ループを追加してください
組み合わせ： github

組み合わせ

他のMCPと組み合わせて10倍の力を

mcpo-openapi-mcp + filesystem

生成された/openapi.jsonをレビュー用にリポジトリに保存する

Save current /openapi.json to /api/contracts/$(date +%F).json.✓ コピーしました
mcpo-openapi-mcp + github

OpenAPIスペックが変わったときにPRをオープンする

If the snapshot diff is non-empty, open a PR titled 'OpenAPI changed'.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
GET /docs (browser) ツール表面を視覚的に探索する free
GET /openapi.json (none) コード生成 / function-callingスペック free
POST /<tool> JSON body matching tool input schema HTTP経由でラップされたMCPツールを呼び出す 1 underlying MCP call

コストと制限

運用コスト

APIクォータ
ラップされたMCPのクォータに依存
呼び出しあたりのトークン
約50 tokenのオーバーヘッドを追加
金額
無料（Apache 2.0）
ヒント
プロセスごとに一度ラップしてください；リクエストごとに新しいサブプロセスを生成しないでください

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： ラップされたMCPに環境変数で渡す；mcpo自体は何も保存しない
データ送信先： ラップされたMCPが送信する先と同じ

トラブルシューティング

よくあるエラーと対処法

/toolで404

URLのツール名はMCPのツール名と完全一致する必要があります（大文字小文字を区別）

確認： /docsで正しいパスを確認
基盤MCPがクラッシュした

mcpoはデフォルトで再起動しますがエラーをログします — stderrを確認してください

有効なtokenでOAuth 401

audienceとissuerが設定と一致しているか確認してください；末尾スラッシュが欠けているのが典型的なミス

確認： jwt.ioでJWTをデコードしてaud/issを比較

代替案

mcpo (MCP-to-OpenAPI) 他との比較

代替案代わりに使う場面トレードオフ
sparfenyuk/mcp-proxyOpenAPI表面ではなく、stdio↔HTTPトランスポートブリッジだけが必要な場合mcp-proxyは低レベル；mcpoは/docsとOAuthを提供
FastAPIラッパーを手書きするその隣に非常に特定のビジネスロジックが必要な場合mcpoは90%を無料で提供

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る