> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-mintlify-b90d3c69.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy Partner MCP

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

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

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 キー](/ja/development/api-development/getting-an-api-key)**（`comfyui-` で始まる）— Comfy パートナーダッシュボードから取得

***

## インストール

```bash theme={null}
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 で共通です：

```json theme={null}
{
  "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 ハンドシェイクが出力されてアイドル状態になれば正常です：

```bash theme={null}
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](/ja/agent-tools/cloud) — Comfy Cloud ワークフロー実行のためのホスト型 MCP サーバー
* [Comfy Partner Nodes CLI](/ja/comfy-cli/reference#generate-partner-nodes) — コマンドラインからパートナーノードを使用