Files

T

koriweb a3f63e56e2 Add ComfyUI wikified docs and youtube extracts; tidy raw→Topics

- 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>

2026-05-20 18:41:10 +09:00

6.1 KiB

Raw Blame History

id, title, category, status, verification_status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, review_reason, merge_history, tags, raw_sources, applied_in, github_commit

title

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 (빠른 시작)

API Key 발급: platform.comfy.org 접속 \rightarrow 로그인 \rightarrow + New 클릭 \rightarrow 이름 입력 \rightarrow 생성 및 즉시 저장(재확인 불가).

클라이언트 연결:

서버 URL: https://cloud.comfy.org/mcp

설정 예시 (Claude Code):

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)

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 본문에서 초안 생성.

6.1 KiB Raw Blame History