Documentation Index
Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
Use this file to discover all available pages before exploring further.
プライベートプレビュー — ウェイトリストが必要です。 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 |
| Amp | 設定 → MCP サーバー、または ~/.config/amp/settings.json |
設定後、MCP クライアントを再起動してください。comfy-partner サーバー下にツールが登録されます。
環境変数
| 変数 | 必須 | 説明 |
|---|
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 コンテンツブロックの強制オン/オフ。 |
利用可能なツール
MCP サーバーは主要な生成モダリティのツールを提供します:
| ツール | 説明 |
|---|
generate_image | テキストプロンプトから画像を生成 |
generate_video | テキストまたは画像から動画を生成 |
generate_3d | 3D モデルを生成(GLB/FBX/OBJ) |
generate_svg | SVG ベクターグラフィックを生成 |
generate_audio | 音声または効果音を生成 |
generate_music | 音楽トラックを生成 |
models_explore | 利用可能なモデルを検索・閲覧 |
balance | アカウント残高を確認 |
regions | 利用可能な生成リージョンを表示 |
使用例
インストール後、AI アシスタントで以下のプロンプトを試してください:
フォトリアリスティックなスタイルで、宇宙に浮かぶ猫の宇宙飛行士の画像を生成して
calm な lo-fi ビートの音楽を30秒くらい生成して
関連ドキュメント