메인 콘텐츠로 건너뛰기
비공개 사전 체험 — 대기자 명단 필요. 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_KEYAPI 키 (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 어시스턴트에서 시도해 보세요:
우주를 떠다니는 고양이 우주비행사의 포토리얼리스틱 스타일 이미지 생성
바다 위 석양의 짧은 동영상 생성
현대적인 의자의 3D 모델 생성
30초 길이의 차분하고 로파이한 분위기의 음악 생성

관련