From becdcfbec9dc02b26acf951028ae0097fe0cb552 Mon Sep 17 00:00:00 2001 From: ComfyUI Wiki Date: Tue, 7 Jul 2026 18:30:59 +0800 Subject: [PATCH] docs(agent-tools): mark Local MCP private test and simplify index lead Clarify that comfy-local-mcp is in private testing and not publicly available yet, and point the agent-tools overview to the local page instead of duplicating setup framing removed after first-party launch. --- agent-tools/index.mdx | 6 ++---- agent-tools/local.mdx | 2 +- ja/agent-tools/index.mdx | 16 ++++++---------- ja/agent-tools/local.mdx | 11 +++++------ ko/agent-tools/index.mdx | 12 +++++------- ko/agent-tools/local.mdx | 13 ++++++------- zh/agent-tools/index.mdx | 12 +++++------- zh/agent-tools/local.mdx | 11 +++++++---- 8 files changed, 37 insertions(+), 46 deletions(-) diff --git a/agent-tools/index.mdx b/agent-tools/index.mdx index 4a04d1a69..aee19a136 100644 --- a/agent-tools/index.mdx +++ b/agent-tools/index.mdx @@ -19,7 +19,7 @@ ComfyUI provides **MCP servers** and **Comfy CLI** so AI agents and developers c Run a local MCP server using the Comfy Partner-Node SDK. Provides unified generate_image, generate_video, generate_3d, and more tools across 30+ partner providers. - First-party local MCP server that drives your **own** ComfyUI install via comfy-cli — run workflows and inspect the nodes and models your machine actually has. *Early preview.* + First-party local MCP server that drives your **own** ComfyUI install via comfy-cli. *Private test; not publicly available yet.* Short agent-oriented overview of comfy generate. For the complete CLI guide, see [Getting started](/comfy-cli/getting-started). @@ -43,9 +43,7 @@ ComfyUI provides **MCP servers** and **Comfy CLI** so AI agents and developers c ## What about local ComfyUI? -Want to drive a **local** ComfyUI install with an agent instead of (or alongside) Comfy Cloud MCP? Comfy now ships a first-party option. - -**Comfy Local MCP (first-party).** [**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) is our official local MCP server — a thin wrapper over [comfy-cli](https://github.com/Comfy-Org/comfy-cli) that lets AI agents run workflows on **your own** ComfyUI and inspect the nodes, custom nodes, and models your install actually has. It is an **early preview**. See [**Comfy Local MCP**](/agent-tools/local) for setup and client configuration. +Want to drive a **local** ComfyUI install with an agent instead of (or alongside) Comfy Cloud MCP? See [**Comfy Local MCP**](/agent-tools/local) for our first-party local MCP server, setup, and client configuration. It is in **private test** and not publicly available yet. **Community MCP servers.** Several community projects also connect MCP clients to a local ComfyUI instance: diff --git a/agent-tools/local.mdx b/agent-tools/local.mdx index 0b78fc0b4..de29bd40e 100644 --- a/agent-tools/local.mdx +++ b/agent-tools/local.mdx @@ -6,7 +6,7 @@ icon: "server" --- - **Early preview.** `comfy-local-mcp` is an early proof-of-concept. The core loop (`server_info → run_workflow → fetch_outputs`) is validated end-to-end against a live local ComfyUI, but tools and behavior may still change. + **Private test.** `comfy-local-mcp` is in private testing and is not publicly available yet. If you do not have private-test access, you cannot install or use it today. The core loop (`server_info → run_workflow → fetch_outputs`) is validated end-to-end against a live local ComfyUI, but tools and behavior may still change. [**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) is Comfy's **first-party local MCP server** — the official way to drive a **local** ComfyUI install from AI agents (Claude Code, Claude Desktop, Cursor, and other MCP clients). It is a thin wrapper over [comfy-cli](https://github.com/Comfy-Org/comfy-cli): each tool shells out to the `comfy` command, so `comfy-cli` is the engine and there is no code shared with the [Comfy Cloud MCP](/agent-tools/cloud). diff --git a/ja/agent-tools/index.mdx b/ja/agent-tools/index.mdx index d8b96f1d8..0695a9bbd 100644 --- a/ja/agent-tools/index.mdx +++ b/ja/agent-tools/index.mdx @@ -3,12 +3,12 @@ title: "Agent Tools / MCP" description: "Model Context Protocol (MCP) を使用して AI エージェントを ComfyUI に接続し、画像、動画、オーディオ、3D コンテンツを生成します。" sidebarTitle: "概要" icon: "robot" -translationSourceHash: 1d8d589d +translationSourceHash: 52f434b2 translationFrom: agent-tools/index.mdx translationBlockHashes: - "_intro": de00d389 + "_intro": 72089b69 "Which One Should I Use?": fa16d052 - "What about local ComfyUI?": 26614358 + "What about local ComfyUI?": 345c7907 "What is MCP?": bb62fbe5 --- @@ -26,15 +26,13 @@ ComfyUI は **MCP サーバー** と **Comfy CLI** を提供しているので Comfy Partner-Node SDK を使用したローカル MCP サーバー。30以上のパートナープロバイダーに対応する統一された generate_image、generate_video、generate_3d などのツールを提供します。 - 公式のローカル MCP サーバーです。comfy-cli を使用して お使いの ComfyUI インストールを操作し、実際にマシンにあるノードやモデルを確認しながらワークフローを実行できます。早期プレビュー。 + ファーストパーティのローカル MCP サーバーです。comfy-cli を使用して、お使いの ComfyUI インストールを操作します。非公開テスト。まだ一般公開されていません。 comfy generate の短いエージェント向け概要。完全な CLI ガイドは [はじめに](/ja/comfy-cli/getting-started) をご覧ください。 ---- - ## どちらを使うべき？ | | Comfy Cloud MCP | Comfy Partner MCP | Comfy Local MCP | Comfy CLI | @@ -50,11 +48,9 @@ ComfyUI は **MCP サーバー** と **Comfy CLI** を提供しているので ## ローカルのComfyUIは？ -エージェントを使って（Comfy Cloud MCP の代わりに、または併用して）**ローカル**の ComfyUI インストールを操作したいですか？ Comfy は現在、ファーストパーティのオプションを提供しています。 - -**Comfy Local MCP（ファーストパーティ）。** [**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) は公式のローカル MCP サーバーです。[comfy-cli](https://github.com/Comfy-Org/comfy-cli) のシンプルなラッパーで、AI エージェントが**あなた自身の** ComfyUI でワークフローを実行し、インストールされているノード、カスタムノード、モデルを確認できるようにします。**早期プレビュー**です。セットアップとクライアント設定については [**Comfy Local MCP**](/ja/agent-tools/local) をご覧ください。 +エージェントを使って（Comfy Cloud MCP の代わりに、または併用して）**ローカル**の ComfyUI インストールを操作したいですか？ ファーストパーティのローカル MCP サーバー、セットアップ、クライアント設定については [**Comfy Local MCP**](/ja/agent-tools/local) をご覧ください。現在**非公開テスト**中で、まだ一般公開されていません。 -**コミュニティ MCP サーバー** いくつかのコミュニティプロジェクトも MCP クライアントをローカルの ComfyUI インスタンスに接続しています： +**コミュニティ MCP サーバー。** いくつかのコミュニティプロジェクトも MCP クライアントをローカルの ComfyUI インスタンスに接続しています： | プロジェクト | リポジトリ | | --- | --- | diff --git a/ja/agent-tools/local.mdx b/ja/agent-tools/local.mdx index 1a0b47a6d..d6e67c481 100644 --- a/ja/agent-tools/local.mdx +++ b/ja/agent-tools/local.mdx @@ -3,10 +3,10 @@ title: "Comfy Local MCP" sidebarTitle: "Local MCP" description: "AIエージェント（Claude Code、Claude Desktop、Cursor）から自分のローカルComfyUIを操作できる、ファーストパーティのcomfy-local-mcpサーバーを使用します。ワークフローを実行し、出力を収集し、インストールに実際に含まれるノードとモデルを検査します。" icon: "server" -translationSourceHash: 6e3c6f59 +translationSourceHash: 0010e883 translationFrom: agent-tools/local.mdx translationBlockHashes: - "_intro": c7dd095f + "_intro": 3a6fd2da "Requirements": d93ce096 "Installation": 09f9ec59 "Configure your AI client": 69542371 @@ -14,16 +14,15 @@ translationBlockHashes: "Tools": f40c9da1 "Related": 4338f84c --- + - **早期プレビュー。** `comfy-local-mcp` は初期の概念実証です。コアループ (`server_info → run_workflow → fetch_outputs`) は実際のローカル ComfyUI に対してエンドツーエンドで検証されていますが、ツールや動作はまだ変更される可能性があります。 + **非公開テスト。** `comfy-local-mcp` は非公開テスト中であり、まだ一般公開されていません。非公開テストへのアクセス権がない場合、現在はインストールや使用はできません。コアループ (`server_info → run_workflow → fetch_outputs`) は実際のローカル ComfyUI に対してエンドツーエンドで検証されていますが、ツールや動作はまだ変更される可能性があります。 -[**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) とのコード共有はありません。 +[**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+** diff --git a/ko/agent-tools/index.mdx b/ko/agent-tools/index.mdx index cd4976329..4905496c7 100644 --- a/ko/agent-tools/index.mdx +++ b/ko/agent-tools/index.mdx @@ -3,12 +3,12 @@ title: "Agent Tools / MCP" description: "AI 에이전트를 모델 컨텍스트 프로토콜(MCP)을 통해 ComfyUI에 연결하여 이미지, 비디오, 오디오 및 3D 콘텐츠를 생성합니다." sidebarTitle: "개요" icon: "robot" -translationSourceHash: 1d8d589d +translationSourceHash: 52f434b2 translationFrom: agent-tools/index.mdx translationBlockHashes: - "_intro": de00d389 + "_intro": 72089b69 "Which One Should I Use?": fa16d052 - "What about local ComfyUI?": 26614358 + "What about local ComfyUI?": 345c7907 "What is MCP?": bb62fbe5 --- @@ -26,7 +26,7 @@ ComfyUI는 **MCP 서버**와 **Comfy CLI**를 제공하여 AI 에이전트와 Comfy Partner-Node SDK를 사용해 로컬 MCP 서버를 실행하세요. 30개 이상의 파트너 제공업체에서 통합된 generate_image, generate_video, generate_3d 및 기타 도구를 제공합니다. - comfy-cli를 통해 자신의 ComfyUI 설치를 구동하는 공식 로컬 MCP 서버입니다. 워크플로를 실행하고 실제 머신에 있는 노드와 모델을 검사할 수 있습니다. 초기 미리보기 + comfy-cli를 통해 사용자 **자신의** ComfyUI 설치를 구동하는 자사 로컬 MCP 서버입니다. 비공개 테스트; 아직 공개적으로 사용할 수 없습니다. comfy generate에 대한 에이전트 중심의 간략한 개요입니다. 전체 CLI 가이드는 [시작하기](/ko/comfy-cli/getting-started)를 참조하세요. @@ -50,9 +50,7 @@ ComfyUI는 **MCP 서버**와 **Comfy CLI**를 제공하여 AI 에이전트와 ## 로컬 ComfyUI는 어떻게 하나요? -Comfy Cloud MCP 대신(또는 함께) **로컬** ComfyUI 설치를 에이전트로 구동하고 싶으신가요? 이제 Comfy에서 자체(first-party) 옵션을 제공합니다. - -**Comfy Local MCP (자체 제공).** [**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp)는 공식 로컬 MCP 서버입니다. [comfy-cli](https://github.com/Comfy-Org/comfy-cli) 위의 가벼운 래퍼로, AI 에이전트가 **자신의** ComfyUI에서 워크플로를 실행하고 설치된 노드, 커스텀 노드, 모델을 검사할 수 있습니다. **초기 미리보기**입니다. 설정 및 클라이언트 구성은 [**Comfy Local MCP**](/ko/agent-tools/local)를 참조하세요. +Comfy Cloud MCP 대신(또는 함께) **로컬** ComfyUI 설치를 에이전트로 구동하고 싶으신가요? 자체(first-party) 로컬 MCP 서버, 설정 및 클라이언트 구성은 [**Comfy Local MCP**](/ko/agent-tools/local)를 참조하세요. 현재 **비공개 테스트** 중이며 아직 공개적으로 사용할 수 없습니다. **커뮤니티 MCP 서버.** 여러 커뮤니티 프로젝트도 MCP 클라이언트를 로컬 ComfyUI 인스턴스에 연결합니다: diff --git a/ko/agent-tools/local.mdx b/ko/agent-tools/local.mdx index f893d9cf2..6be4c8520 100644 --- a/ko/agent-tools/local.mdx +++ b/ko/agent-tools/local.mdx @@ -3,10 +3,10 @@ title: "Comfy Local MCP" sidebarTitle: "Local MCP" description: "자신의 로컬 ComfyUI를 AI 에이전트(Claude Code, Claude Desktop, Cursor)에서 구동하세요. 공식 comfy-local-mcp 서버를 사용하여 워크플로를 실행하고, 출력을 수집하며, 실제 설치된 노드와 모델을 검사할 수 있습니다." icon: "server" -translationSourceHash: 6e3c6f59 +translationSourceHash: 0010e883 translationFrom: agent-tools/local.mdx translationBlockHashes: - "_intro": c7dd095f + "_intro": 3a6fd2da "Requirements": d93ce096 "Installation": 09f9ec59 "Configure your AI client": 69542371 @@ -14,15 +14,14 @@ translationBlockHashes: "Tools": f40c9da1 "Related": 4338f84c --- + - **초기 미리보기.** `comfy-local-mcp`는 초기 개념 증명(proof-of-concept)입니다. 핵심 루프(`server_info → run_workflow → fetch_outputs`)는 실제 로컬 ComfyUI에 대해 종단 간 검증되었지만, 도구와 동작은 변경될 수 있습니다. + **비공개 테스트.** `comfy-local-mcp`는 비공개 테스트 중이며 아직 공개적으로 사용할 수 없습니다. 비공개 테스트 접근 권한이 없다면 오늘 설치하거나 사용할 수 없습니다. 핵심 루프(`server_info → run_workflow → fetch_outputs`)는 실제 로컬 ComfyUI에 대해 종단 간 검증되었지만, 도구와 동작은 변경될 수 있습니다. -[**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](/ko/agent-tools/cloud)와 코드를 공유하지 않습니다. - -클라우드 및 파트너 서버와 달리, **사용자 자신의 머신**에서 실행되는 ComfyUI와 통신하므로 워크플로를 실행하고 설치에 실제로 있는 노드, 커스텀 노드 및 모델을 검사할 수 있습니다. +[**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](/ko/agent-tools/cloud)와 코드를 공유하지 않습니다. ---- +클라우드 및 파트너 서버와 달리, **사용자 자신의 머신**에서 실행 중인 ComfyUI와 통신하므로 설치에 실제로 있는 워크플로를 실행하고 노드, 커스텀 노드, 모델을 검사할 수 있습니다. ## 요구 사항 diff --git a/zh/agent-tools/index.mdx b/zh/agent-tools/index.mdx index 0e435c6ae..c1d38fe43 100644 --- a/zh/agent-tools/index.mdx +++ b/zh/agent-tools/index.mdx @@ -3,12 +3,12 @@ title: "Agent Tools / MCP" description: "通过 Model Context Protocol (MCP) 将 AI 代理连接到 ComfyUI，用于生成图像、视频、音频和 3D 内容。" sidebarTitle: "概览" icon: "robot" -translationSourceHash: 1d8d589d +translationSourceHash: 52f434b2 translationFrom: agent-tools/index.mdx translationBlockHashes: - "_intro": de00d389 + "_intro": 72089b69 "Which One Should I Use?": fa16d052 - "What about local ComfyUI?": 26614358 + "What about local ComfyUI?": 345c7907 "What is MCP?": bb62fbe5 --- @@ -26,7 +26,7 @@ ComfyUI 提供了 **MCP 服务器** 和 **Comfy CLI**，让 AI 代理和开发 使用 Comfy Partner-Node SDK 运行本地 MCP 服务器。提供统一的 generate_image、generate_video、generate_3d 等工具，覆盖 30+ 合作伙伴提供商。 - 第一方本地 MCP 服务器，通过 comfy-cli 驱动您**自己的** ComfyUI 安装，运行工作流并检查您的机器实际拥有的节点和模型。*早期预览。* + 第一方本地 MCP 服务器，通过 comfy-cli 驱动您**自己的** ComfyUI 安装。*私有测试；尚未公开提供。* 关于 comfy generate 的简短代理导向概述。完整 CLI 指南请参见 [入门](/zh/comfy-cli/getting-started)。 @@ -50,9 +50,7 @@ ComfyUI 提供了 **MCP 服务器** 和 **Comfy CLI**，让 AI 代理和开发 ## 那本地 ComfyUI 呢？ -想用 AI 代理驱动**本地** ComfyUI 安装，而不是（或同时使用）Comfy Cloud MCP 吗？Comfy 现已提供第一方选项。 - -**Comfy Local MCP（第一方）。** [**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) 是我们官方的本地 MCP 服务器。这是 [comfy-cli](https://github.com/Comfy-Org/comfy-cli) 的轻量封装，让 AI 代理能在**您自己的** ComfyUI 上运行工作流，并检查您安装中实际拥有的节点、自定义节点和模型。这是一个**早期预览**。请参阅 [**Comfy Local MCP**](/zh/agent-tools/local) 了解设置和客户端配置。 +想用 AI 代理驱动**本地** ComfyUI 安装，而不是（或同时使用）Comfy Cloud MCP 吗？请参阅 [**Comfy Local MCP**](/zh/agent-tools/local) 了解我们的第一方本地 MCP 服务器、设置和客户端配置。目前处于**私有测试**阶段，尚未公开发布。 **社区 MCP 服务器。** 多个社区项目也将 MCP 客户端连接到本地 ComfyUI 实例： diff --git a/zh/agent-tools/local.mdx b/zh/agent-tools/local.mdx index 900866d09..cc470adfe 100644 --- a/zh/agent-tools/local.mdx +++ b/zh/agent-tools/local.mdx @@ -3,10 +3,10 @@ title: "Comfy Local MCP" sidebarTitle: "本地MCP" description: "使用官方的 comfy-local-mcp 服务器，通过 AI 代理（Claude Code、Claude Desktop、Cursor）驱动你自己的本地 ComfyUI：运行工作流、收集输出，并检查你的安装实际拥有的节点和模型。" icon: "server" -translationSourceHash: 6e3c6f59 +translationSourceHash: 0010e883 translationFrom: agent-tools/local.mdx translationBlockHashes: - "_intro": c7dd095f + "_intro": 3a6fd2da "Requirements": d93ce096 "Installation": 09f9ec59 "Configure your AI client": 69542371 @@ -14,14 +14,17 @@ translationBlockHashes: "Tools": f40c9da1 "Related": 4338f84c --- + - **早期预览。** `comfy-local-mcp` 是一个早期的概念验证。核心循环（`server_info → run_workflow → fetch_outputs`）已针对运行的本地 ComfyUI 进行了端到端验证，但工具和行为可能仍会发生变化。 + **私有测试。** `comfy-local-mcp` 目前处于私有测试阶段，尚未公开发布。如果您没有私有测试访问权限，则今天无法安装或使用它。核心循环（`server_info → run_workflow → fetch_outputs`）已针对运行的本地 ComfyUI 进行了端到端验证，但工具和行为可能仍会发生变化。 -[**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](/zh/agent-tools/cloud) 没有共享任何代码。 +[**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](/zh/agent-tools/cloud) 没有共享任何代码。 与云端和合作伙伴服务器不同，它与运行在**您自己的机器**上的 ComfyUI 通信，因此它可以运行您的工作流，并检查您的安装实际拥有的节点、自定义节点和模型。 +--- + ## 要求 - **Python 3.10+**