Comfy Partner MCP

ローカルで動作する MCP サーバー。30以上のパートナープロバイダー（BFL、Ideogram、Kling、Runway、Veo、Meshy、ElevenLabs など）に対応した統一生成ツールを提供。

プライベートテスト中 — まだ公開されていません。 Comfy Partner MCP サーバーは現在プライベートテスト中です。機能や API は変更される可能性があります。アクセスは招待されたパートナーに限定されています。

Comfy Partner MCP は、AI エージェントに 30以上のパートナープロバイダー（BFL、Ideogram、Kling、Runway、Veo、Meshy、ElevenLabs など）に対応した統一生成ツールを提供するローカル MCP サーバーです。すべての生成タイプで単一の標準リクエスト形式を使用します。

主な機能：

• 🎨 6 つの生成モダリティ — 画像、動画、3D、SVG、オーディオ、音楽
• 🔌 30以上のプロバイダー — 統一インターフェース
• 💻 ローカルサーバー — 自分のマシンで動作、Comfy API に接続
• 🔍 組み込みモデル検索 — BM25 テキスト検索対応
• 🧩 プラグアンドプレイ — Claude Desktop、Claude Code、Amp に対応

---

​

システム要件

• Node.js 20+
• pnpm 10
• Comfy API キー（comfyui- で始まる）— Comfy パートナーダッシュボードから取得

---

​

インストール

git clone <リポジトリURL> partner-mcp
cd partner-mcp
pnpm install
pnpm build

ビルド後、MCP サーバーのランチャーは packages/mcp/dist/bin.js にあります。

---

​

設定

MCP クライアント設定にサーバーを追加します。以下の JSON は Claude Desktop、Claude Code、Amp で共通です：

{
  "mcpServers": {
    "comfy-partner": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/bin.js"],
      "env": {
        "COMFY_API_KEY": "comfyui-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

クライアント設定ファイルの場所：

クライアント	設定ファイル
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%/Claude/claude_desktop_config.json (Windows)
Claude Code	~/.claude/mcp.json（または claude mcp add を実行）
Amp	設定 → MCP サーバー、または ~/.config/amp/settings.json

設定後、MCP クライアントを再起動してください。comfy-partner サーバー下に 10 個のツール が登録されます。

クライアントに組み込む前にサーバーが正常に起動するか確認するには、直接実行してください — JSON-RPC ハンドシェイクが出力されてアイドル状態になれば正常です：

COMFY_API_KEY=comfyui-... node /ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/bin.js

---

​

環境変数

変数	必須	説明
COMFY_API_KEY	はい	API キー（comfyui-…）。X-API-Key ヘッダーとして送信。
COMFY_API_BASE_URL	いいえ	プロキシホストを上書き（デフォルトは本番 Comfy API）。
COMFY_INLINE_LIMIT_KB	いいえ	ツール結果にインライン化する画像バイト数の上限。デフォルト 600。
COMFY_MCP_RESOURCE_LINKS	いいえ	resource_link コンテンツブロックの強制オン/オフ。デフォルトはホワイトリスト（claude-*、mcp-inspector）。

---

​

利用可能なツール

MCP サーバーは 10 個のツール を提供します。インストール成功後、MCP クライアントの comfy-partner サーバー下に全 10 個が表示されます。

ツール	説明
generate_image	静止画像を生成 — テキスト→画像、編集、アップスケール対応
generate_video	動画クリップを生成 — テキスト→動画、画像→動画、リップシンク対応
generate_3d	テキストまたは参考画像から 3D メッシュを生成（GLB/FBX/OBJ）
generate_svg	テキストプロンプトから SVG ベクターイラストを生成
generate_audio	テキストから音声・ボイスクローン・効果音を生成
generate_music	プロンプトからインスト/ボーカル付き音楽を生成
media_upload	ファイル（画像/動画/音声）をアップロードし、generate_* で使える media:<id> 参照を取得
read_media	メディア成果物を取得してインライン表示 — HTTPS URL または media:… トークンを受け付け
models_explore	モデルの探索・能力検索・完全な呼び出し仕様の参照
balance	アカウントの残高（USD）を取得

---

​

使用例

インストール後、AI アシスタントで以下のプロンプトを試してください：

フォトリアリスティックなスタイルで、宇宙に浮かぶ猫の宇宙飛行士の画像を生成して

海に沈む夕日の短い動画を生成して

モダンな椅子の 3D モデルを作成して

calm な lo-fi バイブの音楽を30秒くらい生成して

---

​

関連ドキュメント

• Comfy Cloud MCP — Comfy Cloud ワークフロー実行のためのホスト型 MCP サーバー
• Comfy Partner Nodes CLI — コマンドラインからパートナーノードを使用