> ## 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 Local MCP

> AIエージェント（Claude Code、Claude Desktop、Cursor）から自分のローカルComfyUIを操作できる、ファーストパーティのcomfy-local-mcpサーバーを使用します。ワークフローを実行し、出力を収集し、インストールに実際に含まれるノードとモデルを検査します。

<Warning>
  **早期プレビュー。** `comfy-local-mcp` は初期の概念実証です。コアループ (`server_info → run_workflow → fetch_outputs`) は実際のローカル ComfyUI に対してエンドツーエンドで検証されていますが、ツールや動作はまだ変更される可能性があります。
</Warning>

[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) は Comfy の **ファーストパーティのローカル MCP サーバー**: AI エージェント (Claude Code、Claude Desktop、Cursor、およびその他の MCP クライアント) から **ローカル**の ComfyUI インストールを操作する公式の方法です。これは [comfy-cli](https://github.com/Comfy-Org/comfy-cli) の薄いラッパーであり、各ツールは `comfy` コマンドをシェルアウトし、comfy-cli がエンジンとして機能します。[Comfy Cloud MCP](/ja/agent-tools/cloud) とのコード共有はありません。

クラウドやパートナーサーバーとは異なり、これは **あなたのマシン** で実行されている ComfyUI と通信するため、自分のワークフローを実行したり、インストールに実際に含まれているノード、カスタムノード、モデルを検査したりできます。

***

## 要件

* **Python 3.10+**
* **[comfy-cli](https://github.com/Comfy-Org/comfy-cli)** が `PATH` に設定されていること（`pip install comfy-cli`）： すべてのツールがラップするエンジン
* **ComfyUI ワークスペース**： ワークスペースがない場合は `comfy install` で作成してください（既存のチェックアウトがある場合は `comfy set-default <パス>` で対応可能）
* **実行中の ComfyUI**： ツールを使用する前に `comfy launch` で起動してください。ここでの操作は ComfyUI を暗黙的に起動しません

## インストール

[リポジトリ](https://github.com/Comfy-Org/comfy-local-mcp) をチェックアウトしてから:

```bash theme={null}
pip install .        # または作業用コピーの場合は `pip install -e .`
```

これにより、`comfy-local-mcp` コンソールスクリプトが `PATH` に配置されます。このコマンドはMCPサーバーであり（stdio経由でMCPを通信します）。以下の手順でAIクライアントを指定してください。

<Note>
  **`COMFY_BIN`（オプション）。** MCPクライアントはサーバーを独自の環境で起動するため、シェルの `PATH` が含まれていないことがよくあります。`comfy` が仮想環境や非スタンダードな場所にある場合は、`COMFY_BIN` に絶対パス（例：`/path/to/venv/bin/comfy`）を設定してください。以下の各クライアントの例で設定場所を示します。クライアントがサーバーを起動する環境にすでに `comfy` が含まれている場合は、設定を省略してください。
</Note>

***

## AIクライアントの設定

すべてのクライアントは同じMCP stdioコントラクトを使用します。`comfy-local-mcp` コマンドをサーバーとして実行します。お好みのクライアントを選択してください。

### Claude Code

1つのコマンドでサーバーを登録します。

```bash theme={null}
claude mcp add comfy-local -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-local-mcp
```

または、プロジェクトのルートに `.mcp.json` ファイルを作成して登録することもできます。

```json theme={null}
{
  "mcpServers": {
    "comfy-local": {
      "command": "comfy-local-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}
```

### Claude Desktop

`claude_desktop_config.json` を編集します（設定 → デベロッパー → 設定を編集。macOSの場合は `~/Library/Application Support/Claude/claude_desktop_config.json` にあります）。サーバーを追加し、Claude Desktopを再起動します。

```json theme={null}
{
  "mcpServers": {
    "comfy-local": {
      "command": "comfy-local-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}
```

### Cursor

`~/.cursor/mcp.json`（グローバル）または `.cursor/mcp.json`（プロジェクトごと）にサーバーを追加します。

```json theme={null}
{
  "mcpServers": {
    "comfy-local": {
      "command": "comfy-local-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}
```

***

## クイックスタート

ゼロから画像生成まで：

<Steps>
  <Step title="必要なコンポーネントをインストール">
    ```bash theme={null}
    pip install comfy-cli     # エンジン
    comfy install             # ComfyUIのワークスペースを作成（既存の場合はスキップ）
    pip install .             # このMCPサーバー → `comfy-local-mcp`コマンド
    ```
  </Step>

  <Step title="ComfyUIを起動して実行したままにする">
    ```bash theme={null}
    comfy launch
    ```
  </Step>

  <Step title="サーバーをクライアントに追加">
    上記のクライアント用のスニペットを使用し、クライアントを再起動またはリロードしてツールを表示させてください。
  </Step>

  <Step title="エージェントにワークフローを実行させる">
    例：

    > "ローカルのComfyUIが動作していることを確認し、`~/workflows/txt2img.json`のワークフローを実行して、画像を表示してください。"

    内部では、エージェントは`server_info`を呼び出してComfyUIの起動を確認し、`run_workflow`でワークフローJSONを実行し、`fetch_outputs`で結果を収集します。
  </Step>
</Steps>

***

## ツール

各ツールは、`comfy-cli` コマンドにマッピングされ、`--where local` を指定して実行されます。ハイライト:

| ツール                                         | 目的                                                         |
| ------------------------------------------- | ---------------------------------------------------------- |
| `server_info()`                             | ローカルのComfyUIが実行中かどうか、場所、そしてどのワークスペースかを確認します。**最初に呼び出します。** |
| `run_workflow(workflow_path, wait=True)`    | ワークフローJSONを実行します。`wait=False` で非同期に送信し、`prompt_id` を返します。  |
| `job_status` / `wait_for_job` / `watch_job` | 送信されたジョブをポーリング、待機、またはストリーミングします。                           |
| `fetch_outputs(prompt_id, out_dir)`         | 完了したジョブの出力を `out_dir` にコピーします。                             |
| `launch_comfyui` / `stop_comfyui`           | ローカルのComfyUIを起動または停止します。                                   |
| `search_templates` / `fetch_template`       | 組み込みテンプレートを見つけ、実行可能なワークフローJSONを書き出します。                     |
| `search_nodes` / `get_node` / `list_nodes`  | **ライブローカル** インストール内のノードクラスを検査します（カスタムノードを含む）。              |
| `search_models`                             | ディスク上のモデルファイルを一覧表示します。                                     |
| `validate_workflow`                         | 遅い実行の前に、ライブの `object_info` に対してワークフローを事前チェックします。           |

ノード内省とモデル検索は、**ライブインストール**（カスタムノードを含む）を読み取ります。これがクラウドMCPとのローカルの差別化要因です。完全なツール一覧とリファレンスについては、[リポジトリ](https://github.com/Comfy-Org/comfy-local-mcp) を参照してください。

***

## 関連リンク

* [Comfy Cloud MCP](/ja/agent-tools/cloud): ホスト型MCPサーバー、ローカルインストールやGPUは不要
* [Comfy Partner MCP](/ja/agent-tools/partner-mcp): Comfy APIを介した30以上のパートナープロバイダー向けのローカルサーバー
* [Comfy CLI](/ja/agent-tools/comfy-cli): ターミナルからローカルのComfyUIとパートナー生成を操作
* [comfy-local-mcp on GitHub](https://github.com/Comfy-Org/comfy-local-mcp): ソース、インストール、ツールリファレンス