Comfy Partner MCP

비공개 프리뷰 — 아직 공개되지 않았습니다. Comfy Partner MCP 서버는 현재 비공개 테스트 중입니다. 기능과 API는 변경될 수 있습니다. 액세스는 초대된 파트너로 제한됩니다.

Comfy Partner MCP는 BFL, Ideogram, Kling, Runway, Veo, Meshy, ElevenLabs 등 30개 이상의 파트너 제공업체에 걸쳐 AI 에이전트에게 통합된 생성 도구를 제공하는 로컬 MCP 서버입니다. 모든 생성 유형에 대해 단일 표준 요청 형식을 사용합니다. 주요 특징:

🎨 6가지 생성 모달리티 — 이미지, 동영상, 3D, SVG, 오디오, 음악
🔌 30개 이상의 제공업체 한 인터페이스로 통합
💻 로컬 서버 — 사용자의 컴퓨터에서 실행되며 Comfy API와 연결됩니다.
🔍 내장된 모델 검색 및 BM25 텍스트 검색 기능
🧩 Claude Desktop, Claude Code, Amp와 즉시 호환 가능

요구 사항

Node.js 20+
pnpm 10
Comfy API 키 (‘comfyui-’로 시작) — Comfy 파트너 대시보드에서 받으세요

설치

git clone <repo-url> partner-mcp
cd partner-mcp
pnpm install
pnpm build

빌드 후, MCP 서버 런처는 packages/mcp/dist/bin.js에 있습니다.

구성

서버를 MCP 클라이언트 구성에 추가하세요. 같은 JSON 형식은 Claude Desktop, Claude Code, Amp에서도 동일하게 작동합니다:

{
  "mcpServers": {
    "comfy-partner": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/bin.js"],
      "env": {
        "COMFY_API_KEY": "comfyui-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

클라이언트 구성 위치:

클라이언트	구성 파일
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`

구성 추가 후, MCP 클라이언트를 다시 시작하세요. 그러면 comfy-partner 서버 아래에 10개의 도구가 등록된 것을 확인할 수 있습니다. 서버를 클라이언트에 연결하기 전에 정상적으로 시작되는지 확인하려면 직접 실행해 보세요—JSON-RPC 핸드셰이크 메시지를 출력하고 이후 유휴 상태가 되어야 합니다:

COMFY_API_KEY=comfyui-... node /ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/bin.js

환경 변수

변수	필수	목적
`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`	정지 이미지 생성 — 텍스트 기반 이미지 생성, 편집 또는 업스케일링
`generate_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 어시스턴트에서 시도해 보세요:

우주를 떠다니는 고양이 우주비행사의 포토리얼리스틱 스타일 이미지 생성

바다 위 석양의 짧은 동영상 생성

현대적인 의자의 3D 모델 생성

30초 길이의 차분하고 로파이한 분위기의 음악 생성

시작하기

Agent Tools / MCP

기본 개념

인터페이스 가이드

튜토리얼

파트너 노드

Comfy Partner MCP

요구 사항

설치

구성

환경 변수

사용 가능한 도구

예제 프롬프트

관련

​요구 사항

​설치

​구성

​환경 변수

​사용 가능한 도구

​예제 프롬프트

​관련

요구 사항

설치

구성

환경 변수

사용 가능한 도구

예제 프롬프트

관련