Turn any REST API into an MCP server in one command

mcpify

あらゆる REST API を、1 つのコマンドで MCP サーバーに変換します。 mcpify に OpenAPI 仕様を指定すると、すべてのエンドポイントが AI エージェント（Claude、Cursor、Windsurf、…）から 呼び出せるツールになります。接着コードも、エンドポイントごとのラッパーも不要です。

mcpify https://api.example.com/openapi.json

これだけです。仕様内のすべての操作が、すぐに使える MCP ツールになります。

---

理由

MCP は、AI エージェントが実際のツールを呼び出すための仕組みです。しかし、既存の API を MCP に接続するには、エンドポイントごとにツールラッパーを手作業で作成する必要があり、手間がかかるうえ、API が変更されるとすぐに古くなってしまいます。ほとんどの API はすでに OpenAPI 仕様を公開しています。 mcpify はその仕様を読み取り、実行時に MCP サーバー全体を生成するため、次のことが可能です。

• エンドポイントごとのコードが不要 — N 個のエンドポイントが、自動的に N 個のツールになります。
• 常に同期 — 仕様から再生成できるため、保守するラッパーはありません。
• 認証に対応 — API キー／ベアラートークンを一度渡すだけで、すべての呼び出しに適用されます。

インストール

pipx install mcpify-cli      # or: uvx mcpify-cli ...

使い方

仕様から生成されるツールをプレビューします（サーバーは起動しません）。

mcpify --list examples/petstore-mini.yaml

MCP サーバーとして実行します（stdio）。

mcpify https://petstore3.swagger.io/api/v3/openapi.json
mcpify ./openapi.yaml --base-url https://staging.internal.api
mcpify ./openapi.yaml --auth "Authorization: Bearer $TOKEN"   # or set MCPIFY_AUTH

Claude に接続する

MCP クライアントの設定（Claude Desktop／Claude Code mcp.json）に追加します。

{
  "mcpServers": {
    "petstore": {
      "command": "mcpify",
      "args": ["https://petstore3.swagger.io/api/v3/openapi.json"]
    }
  }
}

クライアントを再起動して、「利用可能なペットの一覧を表示して」と尋ねると、Claude が API を直接呼び出します。

仕組み

1. OpenAPI 3.x ドキュメントを読み込みます（URL またはファイル、JSON または YAML）。
2. すべてのパス／メソッドを走査し、生成した JSON 入力スキーマを持つ Operation に変換します。
3. MCP 経由で提供します。各ツールの呼び出しは実際の HTTP リクエストに対応付けられ（パス、クエリ、ヘッダーパラメーター、JSON ボディをすべて処理）、レスポンスがエージェントに返されます。

対応機能

• URL またはローカルファイルから読み込む OpenAPI 3.x（JSON または YAML）
• GET／POST／PUT／PATCH／DELETE
• パス、クエリ、ヘッダーの各パラメーター、JSON リクエストボディ
• グローバル認証ヘッダー 1 つ（API キーまたはベアラートークン）

ロードマップ

• 大規模な API の一部だけを公開する、操作ごとのフィルタリング（--only、--tag）
• 完全に展開されたボディスキーマを実現する $ref の解決
• Swagger 2.0 仕様
• stdio に加え、SSE／HTTP トランスポート

PR を歓迎します。

ライセンス

MIT