- 🎨 6가지 생성 모달리티 — 이미지, 동영상, 3D, SVG, 오디오, 음악
- 🔌 30개 이상의 제공업체 한 인터페이스로 통합
- 💻 로컬 서버 — 사용자의 컴퓨터에서 실행되며 Comfy API와 연결됩니다.
- 🔍 내장된 모델 검색 및 BM25 텍스트 검색 기능
- 🧩 Claude Desktop, Claude Code, Amp와 즉시 호환 가능
요구사항
- Node.js 20+
- pnpm 10
- Comfy API 키 (‘comfyui-’로 시작) — Comfy 파트너 대시보드에서 받으세요
설치
packages/mcp/dist/bin.js에 있습니다.
구성
서버를 MCP 클라이언트 구성에 추가하세요. 같은 JSON 형식은 Claude Desktop, Claude Code, Amp에서도 동일하게 작동합니다:| 클라이언트 | 구성 파일 |
|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%/Claude/claude_desktop_config.json (Windows) |
| Claude Code | ~/.claude/mcp.json (또는 claude mcp add 실행) |
| Amp | 설정 → MCP 서버, 또는 ~/.config/amp/settings.json |
comfy-partner 서버 아래에 10개의 도구가 등록된 것을 확인할 수 있습니다.
서버를 클라이언트에 연결하기 전에 정상적으로 시작되는지 확인하려면 직접 실행해 보세요—JSON-RPC 핸드셰이크 메시지를 출력하고 이후 유휴 상태가 되어야 합니다:
환경 변수
| 변수 | 필수 | 목적 |
|---|---|---|
COMFY_API_KEY | 예 | API 키 (comfyui-…). X-API-Key 헤더로 전송됩니다. |
COMFY_API_BASE_URL | 아니요 | 프록시 호스트 재정의 (기본값은 프로덕션 Comfy API). |
COMFY_INLINE_LIMIT_KB | 아니요 | 도구 결과에 이미지 바이트를 인라인으로 포함하는 최대 크기(KB). 기본값 600. |
COMFY_MCP_RESOURCE_LINKS | 아니요 | resource_link 콘텐츠 블록 활성화/비활성화 강제. 기본값은 허용 목록(claude-*, mcp-inspector)입니다. |
사용 가능한 도구
MCP 서버는 10개의 도구를 노출합니다. 성공적으로 설치한 후, MCP 클라이언트는comfy-partner 서버 아래에 등록된 10개의 도구 모두를 표시해야 합니다.
| 도구 | 설명 |
|---|---|
generate_image | 정지 이미지 생성 — 텍스트-to-image, 편집 또는 업스케일링 |
generate_video | 동영상 클립 생성 — 텍스트-to-video, 이미지-to-video 또는 립싱크 |
generate_3d | 텍스트 또는 참조 이미지로부터 3D 메쉬(GLB/FBX/OBJ) 생성 |
generate_svg | 텍스트 프롬프트로부터 SVG 벡터 일러스트레이션 생성 |
generate_audio | 텍스트로부터 음성, 보이스 클론 또는 효과음 생성 |
generate_music | 프롬프트로부터 악기나 보컬 음악 생성 |
media_upload | 파일(이미지/동영상/오디오) 업로드 및 media:<id> 참조 획득 — generate_* 호출에 사용 |
read_media | 미디어 아트팩트를 가져와 인라인으로 렌더링 — HTTPS URL 또는 media:… 토큰 수락 |
models_explore | 모델 탐색, 기능별 검색 및 모델의 전체 호출 형식 읽기 |
balance | 현재 계정의 남은 USD 잔액 조회 |
예제 프롬프트
설치 후, 다음을 AI 어시스턴트에서 시도해 보세요:관련
- Comfy Cloud MCP — Comfy Cloud 워크플로우 실행을 위한 호스팅 MCP 서버
- Comfy Partner Nodes CLI — 명령줄에서 파트너 노드 사용