koriweb
a3f63e56e2
- 10_Wiki/Comfyui/: ComfyUI docs generated via /wikify - 00_Raw/_youtube/: /youtube extraction outputs - Move some 00_Raw originals into 10_Wiki/Topics_meeting; remove empty canvases and stray files Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
110 lines
6.1 KiB
Markdown
110 lines
6.1 KiB
Markdown
---
|
|
id: comfyui-mcp-server---comfyui
|
|
title: "ComfyUI MCP Server - ComfyUI"
|
|
category: "10_Wiki/Topics"
|
|
status: "draft"
|
|
verification_status: "conceptual"
|
|
canonical_id: ""
|
|
aliases: []
|
|
duplicate_of: ""
|
|
source_trust_level: "B"
|
|
confidence_score: 0.8
|
|
created_at: 2026-05-20
|
|
updated_at: 2026-05-20
|
|
review_reason: ""
|
|
merge_history: []
|
|
tags: ["web", "wikify"]
|
|
raw_sources: ["https://docs.comfy.org/development/cloud/mcp-server"]
|
|
applied_in: []
|
|
github_commit: ""
|
|
---
|
|
|
|
# [[ComfyUI MCP Server - ComfyUI]]
|
|
|
|
## 🎯 한 줄 통찰 (One-line insight)
|
|
[[Model Context Protocol]] (MCP)를 통해 AI 에이전트([[Claude]], [[Cursor]] 등)를 [[Comfy Cloud]]와 연결하여 로컬 GPU 없이 클라우드에서 워크플로우를 실행하고 이미지를 생성하는 서버 서비스입니다.
|
|
|
|
## 🧠 핵심 개념 (Core concepts)
|
|
* **[[Model Context Protocol]] (MCP) 연동**: AI 어시스턴트가 [[Comfy Cloud]]의 기능을 사용할 수 있도록 도구(Tools)와 리소스를 연결합니다.
|
|
* **클라우드 기반 실행**: 로컬 GPU 설치 없이 클라우드 GPU를 활용하여 워크로드를 처리하며, API 키를 통해 인증합니다.
|
|
* **자동화된 워크플로우 생성**: AI 에이전트가 자연어 명령을 바탕으로 [[ComfyUI]] API 형식의 JSON 워크플로우를 구성하고 실행합니다.
|
|
* **Discovery & Execution**: 템플릿, 모델, 노드를 검색하는 기능과 작업 제출, 파일 업로드, 상태 확인 등의 실행 도구를 제공합니다.
|
|
|
|
## 🧩 추출된 패턴 (Extracted patterns)
|
|
* **Client-Server 구조**: MCP 클라이언트(Claude Desktop, Cursor 등)가 지정된 URL(`https://cloud.comfy.org/mcp`)로 접속하여 기능을 호출하는 방식입니다.
|
|
* **도구 중심의 기능 분할**:
|
|
* `Discovery`: 검색 및 탐색 도구
|
|
* `Execution`: 워크플로우 실행 및 관리 도구
|
|
* `Saved Workflows`: 저장된 워크플로우 관리 도구
|
|
* **단계별 설정 프로세스**: API 키 발급 $\rightarrow$ 클라이언트 연결 설정 $\rightarrow$ 서버 URL 및 헤더(X-API-Key) 구성 순으로 진행됩니다.
|
|
|
|
## 📖 세부 내용 (Details)
|
|
|
|
### 🛠️ Available Tools (사용 가능한 도구)
|
|
|
|
#### 1. Discovery (탐색)
|
|
| Tool | Description |
|
|
| :--- | :--- |
|
|
| `search_templates` | 텍text, 태그, 미디어 유형 또는 모델을 통해 미리 구축된 워크플Longrightarrow 템플릿 검색 |
|
|
| `search_models` | 텍스트, 타입, 베이스 모델 또는 소스를 통해 모델 카탈로그 검색 |
|
|
| `search_nodes` | 텍스트, 카테고리 또는 입/출력 유형을 통해 사용 가능한 노드 검색 |
|
|
|
|
#### 2. Execution (실행)
|
|
| Tool | Description |
|
|
| :--- | :--- |
|
|
| `submit_workflow` | Comfy Cloud에서 실행할 ComfyUI API 형식의 워크플로우 제출 |
|
|
| `upload_file` | 워크플로우(예: LoadImage)에서 사용할 입력 이미지 또는 파일 업로드 |
|
|
| `get_job_status` | 제출된 워크플로우의 실행 상태 폴링(Polling) |
|
|
| `get_output` | 완료된 워크플로우로부터 출력 이미지, 비디오 또는 오디오를 가져옴 |
|
|
| `use_previous_output` | 하나의 출력을 다른 것의 입력으로 재사용하여 워크플로우 체인 형성 |
|
|
| `cancel_job` | 대기 중이거나 실행 중인 작업 취소 |
|
|
| `get_queue` | 실행 중이거나 대기 중인 작업 수 확인 |
|
|
|
|
#### 3. Saved Workflows (저장된 워크플로우)
|
|
| Tool | Description |
|
|
| :--- | :--- |
|
|
| `list_saved_workflows` | Comfy Cloud에서 저장된 워크플로우 목록 탐색 |
|
|
| `get_saved_workflow` | 저장된 워크플릿의 노드, 입력 및 구성을 검사 |
|
|
|
|
### 🚀 Quick Start (빠른 시작)
|
|
1. **API Key 발급**: [platform.comfy.org](https://platform.comfy.org/login) 접속 $\rightarrow$ 로그인 $\rightarrow$ `+ New` 클릭 $\rightarrow$ 이름 입력 $\rightarrow$ 생성 및 즉시 저장(재확인 불가).
|
|
2. **클라이언트 연결**:
|
|
* 서버 URL: `https://cloud.comfy.org/mcp`
|
|
* 설정 예시 (Claude Code):
|
|
```bash
|
|
claude mcp add comfyui-cloud \
|
|
--transport http \
|
|
https://cloud.comfy.org/mcp \
|
|
-H "X-API-Key: your-api-key-here"
|
|
```
|
|
|
|
### ⚠️ Known Limitations (알려진 제한 사항)
|
|
* **워크플로우 실행**: 저장된 워크플로우 ID로 직접 실행 불가(브라우징만 가능). 에이전트가 처음부터 재구성해야 함.
|
|
* **메타데이터 부재**: 생성된 자산에 워크플로우 JSON 메타데이터가 포함되지 않음.
|
|
* **정확도 의존성**: 복잡한 노드 구성은 AI의 자연어 처리 능력에 따라 반복 작업이 필요할 수 있음.
|
|
* **인증**: API Key 방식만 지원하며, OAuth는 아직 미지원.
|
|
|
|
## ⚖️ 모순 및 업데이트 (Contradictions & updates)
|
|
* **연구 프리뷰(Research Preview)**: 현재 이 프로젝트는 제한된 초기 액세스(Limited Early Access) 상태이며, 기능과 동작이 변경될 수 있습니다.
|
|
|
|
## 🛠️ 적용 사례 (Applied in summary)
|
|
* **Example Prompts**:
|
|
* "우주를 떠다니는 우주비행사 고양이 이미지 생성 (카툰 스타일)"
|
|
* "텍스트-비디오 생성을 위한 워크플로우 템플릿 찾기"
|
|
* "SDXL 체크포인트 모델 검색 및 가용성 확인"
|
|
|
|
## ✅ 검증 상태 및 신뢰도
|
|
- **상태:** draft
|
|
- **검증 단계:** conceptual
|
|
- **출처 신뢰도:** B (Primary Source — 웹사이트 본문 직접 추출)
|
|
- **중복 검사 결과:** 신규 생성 (New discovery)
|
|
|
|
## 🔗 관련 문서 링크 (Related document links)
|
|
* [[Comfy Cloud]] - MCP 서버가 연결되는 대상 클라우드 인프라입니다.
|
|
* [[Model Context Protocol]] - AI 에이전트와 서버를 연결하는 표준 프로토콜입니다.
|
|
* [[Claude Desktop]] - MCP 서버를 사용할 수 있는 주요 클라이언트 중 하나입니다.
|
|
* [[Cursor]] - MCP 서버를 통해 워크플로우 실행이 가능한 AI 코드 에디터입니다.
|
|
* [[ComfyUI API Format]] - 에이전트가 생성해야 하는 워크플로우의 데이터 규격입니다.
|
|
|
|
## 📝 변경 이履歴 (Change history)
|
|
- 2026-05-20: Astra /wikify 로 https://docs.comfy.org/development/cloud/mcp-server 본문에서 초안 생성. |