BeefChicken MCP 🚀

💡 これは何？

BeefChicken MCP は、任意の openapi.yaml を配置するだけで、対象の Web API を Claude や Cursor などの MCPクライアント から直接呼び出せるようにする汎用 MCP サーバー（プロキシ）です。

特定のAPIに依存する実装コードは一切不要。APIキーを直接指定できないクライアント向けに 簡易 OAuth 2.1 サーバー まで同梱しているため、Claude.ai (Web版) にもそのまま接続できます。

graph LR
    subgraph Client [AIクライアント]
        Claude[🤖 Claude.ai / Cursor 等]
    end

    subgraph Proxy [BeefChicken MCP]
        MCP[⚡ MCPサーバー<br/>Workers / Node.js / Docker]
        OAuth[🔐 内蔵 OAuth 2.1]
    end

    subgraph Target [接続先API]
        Spec[📄 docs/openapi.yaml]
        API[🌐 対象Web API<br/>Stripe / GitHub / 社内API]
    end

    Spec -->|ビルド時静的JSON化| MCP
    Claude -->|MCPプロトコル / OAuth| MCP
    MCP -->|ネイティブfetch| API

Related MCP server: OpenAPI MCP Server

⚡ なぜ BeefChicken MCP なのか？

❌ 従来の課題

• MCPサーバーを作るために、TypeScriptやPythonでツール定義やリクエストハンドラをガリガリ書く必要がある。

• APIの仕様変更のたびにコードを修正・テストして再デプロイするのが大変。

• Claude.ai (Web版) で自作ツールを使いたいが、OAuth 2.1 認証サーバー構築のハードルが高い。

✅ BeefChicken MCP なら

• 🧩 コード記述 0 行: docs/openapi.yaml を繋ぎたいAPIの仕様書に差し替えるだけ！

• 🔐 Claude.ai (Web版) 即対応: 簡易 OAuth 2.1 サーバー内蔵で、Web版Claudeのカスタムコネクタも一発接続。

• ⚡️ サーバー維持費 0 円: Cloudflare Workers に数秒でデプロイ（Docker / Node.js にも対応）。無料枠内ならタダでMCPサーバーがあなたのものに。

• 📦 超軽量＆ゼロパースオーバーヘッド: ビルド時に OpenAPI 仕様書を静的 JSON へ変換。実行時の YAML パースは一切不要。

📊 他の手段との比較

✨ 主な特徴

• 🧩 設定ファイルの差し替えだけで完結: コードを1行も書かずに任意の Web API を MCP ツール化。

• 🎯 専用プロキシに徹した設計: 複雑なハンドラ記述を排除し、仕様書通りの純粋なプロキシとして動作。

• 📦 静的JSON変換: 実行時の YAML パーサーや $ref 解決ロジックを非搭載にし、Worker バンドルサイズを最小化。

• 🔌 ネイティブ fetch 中継: 余計な HTTP クライアントライブラリを挟まずレスポンスをダイレクト中継。

• 🛡️ Stateless & Robust: SSE 長時間保持に依存しない responseMode: 'json' 構成。タイムアウト制限に強い堅牢設計。

⚠️ 本番公開前の注意点: 本サーバー自体にはレート制限がありません。公開時は Cloudflare の Rate Limiting Rules やリバースプロキシ等で制御してください。また同梱の OAuth 2.1 サーバーは簡易実装です。詳細は 認証ドキュメント を確認してください。

🚀 クイックスタート

1. 仕様書の配置

docs/openapi.yaml を繋ぎたい API の OpenAPI 3.0 仕様書に差し替えます。

💡 ヒント: Stripe や GitHub などの標準 OpenAPI は公式や APIs.guru 等から入手できます。

npm install
npm run generate   # docs/openapi.yaml を解析し、src/generated/tools.json を自動生成

2. デプロイ / 実行

Cloudflare Workers の場合:

npx wrangler deploy

成功すると https://beefchicken-mcp.<あなたのサブドメイン>.workers.dev/mcp が発行されます（D1設定等の詳細は デプロイ手順 参照）。

Node.js の場合:

API_BASE_URL=https://api.example.com npm run node:dev

Docker の場合:

docker build -t beefchicken-mcp .
docker run -p 3000:3000 \
  -e HOST=0.0.0.0 \
  -e ALLOWED_HOSTS=127.0.0.1,localhost \
  -e API_BASE_URL=https://api.example.com \
  beefchicken-mcp

3. クライアントから接続

発行された URL に対し Authorization: Bearer <対象APIのAPIキー> ヘッダーを付けて MCP クライアントに設定します。

📚 ドキュメント

📜 ライセンス

MIT License. 詳細は LICENSE を参照してください。