From c0d7e0a3c86521834b5e18cd1734c1e8161ceea0 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sun, 29 Mar 2026 14:44:40 +0000 Subject: [PATCH] Add zh-CN and ja translations for MCP Server page Generated-By: mintlify-agent --- docs.json | 6 +- ja/development/cloud/mcp-server.mdx | 210 +++++++++++++++++++++++++ zh-CN/development/cloud/mcp-server.mdx | 209 ++++++++++++++++++++++++ 3 files changed, 423 insertions(+), 2 deletions(-) create mode 100644 ja/development/cloud/mcp-server.mdx create mode 100644 zh-CN/development/cloud/mcp-server.mdx diff --git a/docs.json b/docs.json index 6474e3d82..b096c6c05 100644 --- a/docs.json +++ b/docs.json @@ -4019,7 +4019,8 @@ "pages": [ "zh-CN/development/cloud/overview", "zh-CN/development/cloud/api-reference", - "zh-CN/development/cloud/openapi" + "zh-CN/development/cloud/openapi", + "zh-CN/development/cloud/mcp-server" ] }, { @@ -6108,7 +6109,8 @@ "pages": [ "ja/development/cloud/overview", "ja/development/cloud/api-reference", - "ja/development/cloud/openapi" + "ja/development/cloud/openapi", + "ja/development/cloud/mcp-server" ] }, { diff --git a/ja/development/cloud/mcp-server.mdx b/ja/development/cloud/mcp-server.mdx new file mode 100644 index 000000000..d71ee8520 --- /dev/null +++ b/ja/development/cloud/mcp-server.mdx @@ -0,0 +1,210 @@ +--- +title: "ComfyUI MCP サーバー" +description: "モデルコンテキストプロトコル（MCP）を通じて AI エージェントを Comfy Cloud に接続し、画像生成を行う" +--- + +import GetApiKey from '/snippets/get-api-key.mdx' + + + **リサーチプレビュー：** ComfyUI MCP サーバーは現在、限定的な早期アクセス段階です。機能、ツール、動作はプロジェクトの進化に伴い変更される可能性があります。興味がありますか？[ウェイトリストに登録](https://form.typeform.com/to/hHmvw1UH)。 + + +ComfyUI MCP サーバーは、[モデルコンテキストプロトコル（MCP）](https://modelcontextprotocol.io)を通じて、Claude Desktop、Claude Code、Cursor などの AI アシスタントを [Comfy Cloud](https://cloud.comfy.org) に接続します。AI エージェントがクラウド GPU 上で画像生成、モデル/ノード/テンプレートの検索、ComfyUI ワークフローの実行を行うことができ、ローカル GPU は不要です。 + +## クイックスタート + +### 1. API キーを取得する + + + +### 2. クライアントを接続する + +ComfyUI MCP サーバーは `https://cloud.comfy.org/mcp` でホストされています。ローカルインストールや Node.js は不要です。MCP クライアントをサーバー URL に向けて API キーを設定するだけです。 + + + + ```bash + claude mcp add comfyui-cloud \ + --transport http \ + https://cloud.comfy.org/mcp \ + -H "X-API-Key: your-api-key-here" + ``` + + + + Claude Desktop の設定ファイルに以下を追加してください： + + | OS | 設定ファイルのパス | + |:---|:------------| + | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` | + | Windows | `%APPDATA%\Claude\claude_desktop_config.json` | + | Linux | `~/.config/Claude/claude_desktop_config.json` | + + ```json + { + "mcpServers": { + "comfyui-cloud": { + "url": "https://cloud.comfy.org/mcp", + "headers": { + "X-API-Key": "your-api-key-here" + } + } + } + } + ``` + + + + Cursor の MCP 設定（プロジェクト内の `.cursor/mcp.json` またはグローバル設定）に以下を追加してください： + + ```json + { + "mcpServers": { + "comfyui-cloud": { + "url": "https://cloud.comfy.org/mcp", + "headers": { + "X-API-Key": "your-api-key-here" + } + } + } + } + ``` + + 詳細は [Cursor の MCP ドキュメント](https://docs.cursor.com/context/model-context-protocol)を参照してください。 + + + + + サーバーを追加した後、新しい設定を反映するために MCP クライアントを再起動してください。 + + +--- + +## 利用可能なツール + +### ディスカバリー + +| ツール | 説明 | +|:-----|:------------| +| `search_templates` | テキスト、タグ、メディアタイプ、またはモデルで [comfy.org](https://comfy.org/workflows) のプリビルトワークフローテンプレートを検索 | +| `search_models` | テキスト、タイプ、ベースモデル、またはソースでモデルカタログを検索 | +| `search_nodes` | テキスト、カテゴリ、または入力/出力タイプで利用可能なノードを検索 | + +### 実行 + +| ツール | 説明 | +|:-----|:------------| +| `submit_workflow` | ComfyUI API 形式のワークフローを Comfy Cloud で実行するために送信 | +| `upload_file` | ワークフローで使用する入力画像やファイルをアップロード（例：LoadImage） | +| `get_job_status` | 送信されたワークフローの実行状態をポーリング | +| `get_output` | 完了したワークフローの出力画像、動画、または音声を取得 | +| `use_previous_output` | あるワークフローの出力を別のワークフローの入力として再利用し、ワークフローを連鎖 | +| `cancel_job` | 保留中または実行中のジョブをキャンセル | +| `get_queue` | 実行中および保留中のジョブ数を確認 | + +### 保存済みワークフロー + +| ツール | 説明 | +|:-----|:------------| +| `list_saved_workflows` | Comfy Cloud に保存されたワークフローを閲覧 | +| `get_saved_workflow` | 保存されたワークフローのノード、入力、設定を確認 | + + + サーバーはゼロからワークフローを構築する前に、一致するプリビルトテンプレートがないか確認します。これにより、より良い結果とより高速な生成が実現します。 + + +--- + +## 仕組み + +``` +┌──────────────┐ HTTPS/MCP ┌─────────────────────────────────────────────┐ +│ AI エージェ │◄───────────────►│ Comfy Cloud │ +│ ント │ X-API-Key │ cloud.comfy.org/mcp → クラウド GPU 上で │ +│ (Claude, │ │ ワークフロー実行 │ +│ Cursor) │ │ │ +└──────────────┘ └─────────────────────────────────────────────┘ +``` + +AI エージェントは `cloud.comfy.org/mcp` でホストされている MCP サーバーに直接接続します。サーバーは MCP ツールコールを Comfy Cloud GPU 上のワークフロー実行に変換します。ローカルサーバーや GPU は不要です。 + +AI エージェントはディスカバリーツールを使用してテンプレートやノードを検索し、ComfyUI API 形式のワークフロー JSON を構築して送信し、結果を返します。やりたいことを自然言語で説明するだけです。 + +--- + +## プロンプト例 + +インストール後、AI アシスタントで以下のプロンプトを試してみてください： + +``` +宇宙に浮かぶ猫の宇宙飛行士の画像を生成して、カートゥーンスタイルで +``` + +``` +テキストから動画を生成するワークフローテンプレートを探して +``` + +``` +SDXL チェックポイントモデルを検索して、利用可能なものを教えて +``` + +``` +山と夕暮れ時に光る川のあるファンタジー風景を生成して +``` + +``` +画像のアップスケーリングに使えるノードは？ +``` + +エージェントは一致するテンプレートを検索し、ComfyUI ワークフローを構築して Comfy Cloud に送信し、生成された画像を会話内で直接返します。 + +--- + +## 出力の処理 + +- **画像**は会話内にインラインで表示（Claude Code）、またはアーティファクトサイドパネルに表示（Claude Desktop）されます +- **動画と音声**の出力はダウンロード可能なリンクとして返されます +- **アニメーション画像**（GIF、WebP）は保存されますが、アニメーションを保持するためインラインプレビューは表示されません +- インライン画像プレビューは効率的な表示のため 1024px にリサイズされます。フル解像度の出力は常に `get_output` ツールで取得できます + +--- + +## 既知の制限事項 + + + これは早期リリースです。以下の制限事項が判明しており、積極的に改善中です。 + + +**ワークフロー** +- **保存されたワークフローを ID で実行できません。** 保存されたワークフローの閲覧と確認（`list_saved_workflows`、`get_saved_workflow`）は可能ですが、直接実行はできません。保存されたワークフローは ComfyUI グラフ形式を使用しており、API 形式への変換が必要です。AI エージェントはワークフローをゼロから再構築する必要があります。 +- **生成されたアセットにワークフローメタデータがありません。** MCP サーバーで作成された画像にはメタデータにワークフロー JSON が含まれないため、ComfyUI で開いてもワークフローは表示されません。 +- **ワークフローの精度は AI に依存します。** エージェントは自然言語から ComfyUI ワークフローを構築します。複雑なマルチノードワークフローや特殊なノード設定では、反復が必要になる場合があります。 + +**ファイル処理** +- **アップロードサイズの制限**は MCP クライアントによって異なる場合があります。 +- **画像プレビューはリサイズされます。** インラインプレビューは 1024px（JPEG）に制限されます。フル解像度のファイルはディスクに保存されます。 + +**認証** +- **API キーのみ。** 認証には `X-API-Key` ヘッダーで Comfy Cloud API キーを渡す必要があります。ブラウザベースの OAuth はまだ利用できません。 + +**クライアント固有** +- **Claude Desktop** — 生成された画像はネイティブの画像アーティファクトではなく、HTML を介してアーティファクトサイドパネルに表示されます。 + +--- + +## トラブルシューティング + +### MCP サーバーが表示されない + +MCP クライアントを再起動してください（Claude Code、Claude Desktop、または Cursor を閉じて再度開く）。MCP サーバーは起動時に読み込まれます。設定内のサーバー URL が正確に `https://cloud.comfy.org/mcp` であることを再確認してください。 + +### API キーエラー + +[platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) で API キーが有効であることを確認してください。キーが `X-API-Key` ヘッダーで渡されていることを確認してください（Bearer トークンではありません）。必要に応じて新しいキーを生成し、クライアント設定を更新してください。 + +### 接続エラー + +MCP クライアントがサーバーに接続できない場合、以下を確認してください： +1. アクティブなインターネット接続があること +2. ファイアウォールやプロキシが `cloud.comfy.org` をブロックしていないこと +3. アクティブな [Comfy Cloud サブスクリプション](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api)があること diff --git a/zh-CN/development/cloud/mcp-server.mdx b/zh-CN/development/cloud/mcp-server.mdx new file mode 100644 index 000000000..5a5dda359 --- /dev/null +++ b/zh-CN/development/cloud/mcp-server.mdx @@ -0,0 +1,209 @@ +--- +title: "ComfyUI MCP 服务器" +description: "通过模型上下文协议（MCP）将 AI 代理连接到 Comfy Cloud 进行图像生成" +--- + +import GetApiKey from '/snippets/zh/get-api-key.mdx' + + + **研究预览版：** ComfyUI MCP 服务器目前处于有限的早期访问阶段。功能、工具和行为可能会随着项目发展而变化。感兴趣？[加入等待列表](https://form.typeform.com/to/hHmvw1UH)。 + + +ComfyUI MCP 服务器通过[模型上下文协议（MCP）](https://modelcontextprotocol.io)将 AI 助手（包括 Claude Desktop、Claude Code 和 Cursor）连接到 [Comfy Cloud](https://cloud.comfy.org)。它使 AI 代理能够在云端 GPU 上生成图像、搜索模型/节点/模板以及运行完整的 ComfyUI 工作流，无需本地 GPU。 + +## 快速开始 + +### 1. 获取 API 密钥 + + + +### 2. 连接客户端 + +ComfyUI MCP 服务器托管在 `https://cloud.comfy.org/mcp`。无需本地安装或 Node.js —— 只需将你的 MCP 客户端指向服务器 URL 并提供 API 密钥即可。 + + + + ```bash + claude mcp add comfyui-cloud \ + --transport http \ + https://cloud.comfy.org/mcp \ + -H "X-API-Key: your-api-key-here" + ``` + + + + 将以下内容添加到你的 Claude Desktop 配置文件中： + + | 操作系统 | 配置文件路径 | + |:---|:------------| + | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` | + | Windows | `%APPDATA%\Claude\claude_desktop_config.json` | + | Linux | `~/.config/Claude/claude_desktop_config.json` | + + ```json + { + "mcpServers": { + "comfyui-cloud": { + "url": "https://cloud.comfy.org/mcp", + "headers": { + "X-API-Key": "your-api-key-here" + } + } + } + } + ``` + + + + 将以下内容添加到你的 Cursor MCP 配置中（项目中的 `.cursor/mcp.json` 或全局配置）： + + ```json + { + "mcpServers": { + "comfyui-cloud": { + "url": "https://cloud.comfy.org/mcp", + "headers": { + "X-API-Key": "your-api-key-here" + } + } + } + } + ``` + + 更多详情请参阅 [Cursor 的 MCP 文档](https://docs.cursor.com/context/model-context-protocol)。 + + + + + 添加服务器后，请重启你的 MCP 客户端以加载新配置。 + + +--- + +## 可用工具 + +### 发现 + +| 工具 | 描述 | +|:-----|:------------| +| `search_templates` | 通过文本、标签、媒体类型或模型搜索 [comfy.org](https://comfy.org/workflows) 上的预构建工作流模板 | +| `search_models` | 通过文本、类型、基础模型或来源搜索模型目录 | +| `search_nodes` | 通过文本、类别或输入/输出类型搜索可用节点 | + +### 执行 + +| 工具 | 描述 | +|:-----|:------------| +| `submit_workflow` | 提交 ComfyUI API 格式的工作流以在 Comfy Cloud 上执行 | +| `upload_file` | 上传用于工作流的输入图像或文件（例如 LoadImage） | +| `get_job_status` | 轮询已提交工作流的执行状态 | +| `get_output` | 获取已完成工作流的输出图像、视频或音频 | +| `use_previous_output` | 将一个工作流的输出作为另一个工作流的输入，实现工作流链接 | +| `cancel_job` | 取消待处理或正在运行的任务 | +| `get_queue` | 检查正在运行和待处理的任务数量 | + +### 已保存的工作流 + +| 工具 | 描述 | +|:-----|:------------| +| `list_saved_workflows` | 浏览你在 Comfy Cloud 上保存的工作流 | +| `get_saved_workflow` | 查看已保存工作流的节点、输入和配置 | + + + 服务器会在从头构建工作流之前先检查是否有匹配的预构建模板，从而获得更好的结果和更快的生成速度。 + + +--- + +## 工作原理 + +``` +┌──────────────┐ HTTPS/MCP ┌─────────────────────────────────────────────┐ +│ AI 代理 │◄───────────────►│ Comfy Cloud │ +│ (Claude, │ X-API-Key │ cloud.comfy.org/mcp → 在云端 GPU 上 │ +│ Cursor) │ │ 执行工作流 │ +└──────────────┘ └─────────────────────────────────────────────┘ +``` + +你的 AI 代理直接连接到托管在 `cloud.comfy.org/mcp` 的 MCP 服务器。服务器将 MCP 工具调用转换为 Comfy Cloud GPU 上的工作流执行 —— 无需本地服务器或 GPU。 + +AI 代理使用发现工具查找模板和节点，然后构建 ComfyUI API 格式的工作流 JSON，提交并返回结果 —— 只需用自然语言描述你想要的内容。 + +--- + +## 示例提示 + +安装完成后，在你的 AI 助手中尝试以下提示： + +``` +生成一张太空中漂浮的猫宇航员图像，卡通风格 +``` + +``` +帮我找一些文本转视频的工作流模板 +``` + +``` +搜索 SDXL checkpoint 模型，告诉我有哪些可用的 +``` + +``` +生成一幅奇幻风景画，有山脉和日落时分发光的河流 +``` + +``` +有哪些可用的图像放大节点？ +``` + +代理会搜索匹配的模板，构建 ComfyUI 工作流，将其提交到 Comfy Cloud，并在对话中直接返回生成的图像。 + +--- + +## 输出处理 + +- **图像**会在对话中内联显示（Claude Code）或在工件侧面板中显示（Claude Desktop） +- **视频和音频**输出会以可下载链接的形式返回 +- **动态图像**（GIF、WebP）会被保存但不会内联预览，以保留动画效果 +- 内联图像预览会调整为 1024px 以实现高效显示；全分辨率输出始终可通过 `get_output` 工具获取 + +--- + +## 已知限制 + + + 这是一个早期版本。以下是已知的限制，正在积极改进中。 + + +**工作流** +- **无法通过 ID 运行已保存的工作流。** 你可以浏览和查看已保存的工作流（`list_saved_workflows`、`get_saved_workflow`），但无法直接执行。已保存的工作流使用 ComfyUI 图形格式，需要转换为 API 格式。AI 代理必须从头重建工作流。 +- **生成的资源没有工作流元数据。** 通过 MCP 服务器创建的图像不包含元数据中的工作流 JSON，因此在 ComfyUI 中打开时不会显示工作流。 +- **工作流准确性取决于 AI。** 代理从自然语言构建 ComfyUI 工作流。复杂的多节点工作流或不常见的节点配置可能需要多次迭代。 + +**文件处理** +- **上传大小限制**可能因你的 MCP 客户端而异。 +- **图像预览会被调整大小。** 内联预览限制为 1024px（JPEG）。全分辨率文件会保存到磁盘。 + +**认证** +- **仅支持 API 密钥。** 认证需要通过 `X-API-Key` 头部传递 Comfy Cloud API 密钥。基于浏览器的 OAuth 尚不可用。 + +**客户端特定** +- **Claude Desktop** —— 生成的图像通过 HTML 显示在工件侧面板中，而非原生图像工件。 + +--- + +## 故障排除 + +### MCP 服务器未显示 + +重启你的 MCP 客户端（关闭并重新打开 Claude Code、Claude Desktop 或 Cursor）。MCP 服务器在启动时加载。请仔细检查配置中的服务器 URL 是否正确为 `https://cloud.comfy.org/mcp`。 + +### API 密钥错误 + +在 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) 验证你的 API 密钥是否有效。确保密钥通过 `X-API-Key` 头部传递（而非 Bearer token）。如需要，生成新密钥并更新客户端配置。 + +### 连接错误 + +如果 MCP 客户端无法访问服务器，请检查： +1. 你是否有活跃的互联网连接 +2. 你的防火墙或代理是否阻止了 `cloud.comfy.org` +3. 你是否有活跃的 [Comfy Cloud 订阅](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api)