/ 디렉터리 / 플레이그라운드 / ComfyUI MCP Server
← 모든 서버 ↗ GitHub
● 커뮤니티 joenorton 🔑 본인 키 필요

ComfyUI MCP Server

제작: joenorton · joenorton/comfyui-mcp-server

MCP 도구인 로컬 ComfyUI — ComfyUI UI를 열지 않고도 이미지, 오디오 및 비디오를 생성하고, 워크플로를 실행하고, 자산을 관리합니다.

comfyui-mcp-server는 로컬로 실행되는 ComfyUI(포트 8188)를 모든 MCP 클라이언트에 연결합니다. 에이전트는 MCP 도구를 통해 이미지를 생성 및 재생성하고, 사용자 정의 워크플로를 제출하고, 작업을 폴링 및 취소하고, 생성된 자산을 보고, 모델을 전환하고, 출력을 게시할 수 있습니다. 수동으로 노드를 끌고 싶지 않은 반복적이고 창의적인 작업, 일괄 생성 및 프로그래밍 방식 파이프라인 실행에 유용합니다.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

comfyui-mcp-server.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "comfyui-mcp-server",
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "comfyui-mcp-server": {
      "command": {
        "path": "python",
        "args": [
          "server.py"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add comfyui-mcp-server -- python server.py

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: ComfyUI MCP Server

텍스트 프롬프트로 이미지 컨셉 반복

👤 로컬에서 ComfyUI를 사용하는 디자이너 및 아티스트 ⏱ ~20 min intermediate

언제 쓸까: ComfyUI를 설정했지만 노드 그래프 대신 채팅을 통해 반복하고 싶습니다.

사전 조건
  • 포트 8188에서 실행되는 ComfyUI — ComfyUI 설치를 따르세요. 체크포인트 모델이 models/checkpoints/에 있는지 확인하세요.
  • MCP 서버가 시작되었습니다 — python server.py(http://127.0.0.1:9000/mcp에서 수신)
흐름
  1. v1 생성
    이미지 생성: 실사 인물 사진, 흐린 빛, 1024×1280.✓ 복사됨
    → 작업이 제출되었습니다. ID가 반환되었습니다. 완료되면 이미지가 나타납니다.
  2. 조정으로 재생성
    해당 시드에서 재생성하여 약간 따뜻한 톤을 유지하고 구성을 유지합니다.✓ 복사됨
    → 같은 구성, 더 따뜻한 색상
  3. 보기 + 게시
    최신 이미지를 봅니다. 갤러리에 'portrait-final.png'로 게시하세요.✓ 복사됨
    → 자산 메타데이터 + 게시 URL

결과: 노드를 클릭하지 않고도 빠른 반복이 가능합니다.

함정
  • MCP 서버가 시작되기 전에 ComfyUI가 실행되어야 한다는 사실을 잊음 — 먼저 ComfyUI를 시작한 다음 MCP 서버를 시작하세요.
함께 쓰기: filesystem

채팅에서 저장된 ComfyUI 워크플로 시작

👤 ComfyUI 워크플로가 확립된 팀 ⏱ ~15 min intermediate

언제 쓸까: 이미 워크플로를 구축했습니다. 이제 프로그래밍 방식으로 실행하려고 합니다.

사전 조건
  • ComfyUI에 저장된 워크플로 — 다른 이름으로 저장 → 워크플로 JSON
흐름
  1. 워크플로 나열
    내 워크플로를 나열합니다.✓ 복사됨
    → 이름/ID가 포함된 배열
  2. 실행해 보세요
    positive='대리석 위의 세라믹 머그', negative='흐림'으로 'product-shot-v3'을 실행합니다.✓ 복사됨
    → 작업이 생성되었습니다. 매개변수가 에코됨
  3. 기다려 + 결과 가져오기
    끝나면 알려주고 이미지를 보여주세요.✓ 복사됨
    → 폴링 대기열; 완료되면 자산을 반환합니다.

결과: 채팅을 통한 워크플로 조정 — 일괄 실행에 이상적입니다.

함정
  • 워크플로 참조 사용자 정의 노드가 설치되지 않음 — 실행하기 전에 ComfyUI에 필수 사용자 정의 노드를 설치하십시오.
함께 쓰기: comfy-pilot

비디오 워크플로를 사용하여 짧은 스크립트를 비디오로 변환

👤 단편을 제작하는 콘텐츠 제작자 ⏱ ~45 min advanced

언제 쓸까: ComfyUI 비디오 워크플로(예: AnimateDiff/Mochi)가 있고 프롬프트를 순차적으로 제공하려고 합니다.

흐름
  1. 비디오 워크플로 로드
    장면 목록: [장면 프롬프트]를 사용하여 'shorts-v2' 워크플로를 실행합니다.✓ 복사됨
    → 대기열에 있는 세그먼트; 장면별 진행
  2. 스티치 및 게시
    최종 영상을 공개합니다.✓ 복사됨
    → 출력 경로 + 게시 메타데이터

결과: 로컬 컴퓨팅을 통한 짧은 비디오, 렌더링당 클라우드 요금 없음.

함정
  • 긴 클립의 GPU 메모리 소모 — 세그먼트당 해상도 또는 프레임을 줄입니다. 순차적으로 배치

조합

다른 MCP와 조합해 10배 효율

comfyui-mcp-server + comfy-pilot

전체 파이프라인 작성을 위해 이 MCP를 Claude-Code-in-ComfyUI 편집기와 페어링하세요.

comfy-pilot을 통해 워크플로우를 구축하고 이 MCP 서버를 통해 실행하세요.✓ 복사됨
comfyui-mcp-server + filesystem

생성된 자산을 프로젝트 폴더 아래에 정리

각 배치 후에 출력을 날짜가 지정된 파일 이름과 함께 ./assets/<project>/로 이동합니다.✓ 복사됨
comfyui-mcp-server + mcp-image

일회용 Gemini 세대에는 mcp-image를 사용하세요. 로컬 SD/FLUX 파이프라인을 위한 ComfyUI

mcp-image를 통해 영웅 초안을 작성합니다. ComfyUI 워크플로를 통해 브랜드 세트를 제공합니다.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
generate_image prompt, settings 표준 텍스트를 이미지로 local compute only
generate_song / generate_video prompt, workflow 전용 워크플로우를 통한 오디오/비디오 생성 local compute
regenerate reference job_id, tweaks 이전 결과 반복 local compute
view_image asset_id 자산 인라인 표시 0
get_queue_status / get_job / cancel_job job_id 수명주기 관리 0
list_assets / get_asset_metadata filter 생성된 출력 찾아보기 0
list_models / get_defaults / set_defaults optional model name 체크포인트 전환 또는 기본값 조정 0
list_workflows / run_workflow name + inputs 저장된 워크플로우 실행 0 to start
publish_asset / get_publish_info asset_id 최종 자산 표시 0

비용 및 제한

운영 비용

API 쿼터
로컬 전용 — GPU에 의해 바인딩됨
호출당 토큰
프롬프트 텍스트가 작습니다. 자산 바이트가 크다
금액
무료 — 전기 및 하드웨어
팁
반복을 위해 더 낮은 단계/더 작은 해상도를 사용하십시오. 키퍼에 대한 전체 설정을 예약합니다.

보안

권한, 시크릿, 파급범위

자격 증명 저장: 로컬 ComfyUI에 대한 자격 증명이 없습니다. 클라우드에 프록시하는 경우 프록시에 인증을 추가하세요.
데이터 외부 송신: ComfyUI는 로컬로 실행됩니다. 서버 트래픽은 기본적으로 127.0.0.1입니다. 모델 다운로드는 작업 흐름에 따라 HuggingFace / CivitAI에서 가져옵니다.

문제 해결

자주 발생하는 오류와 해결

연결이 거부되었습니다. 127.0.0.1:8188

먼저 ComfyUI를 시작하세요. 브라우저에서 UI 로드를 확인합니다.

확인: curl localhost:8188/system_stats
사용자 정의 노드가 누락되어 워크플로가 실패합니다.

ComfyUI Manager를 열고 필요한 사용자 정의 노드를 설치한 후 다시 시도하십시오.

확인: Manager → Install Missing Custom Nodes
작업이 대기열에 있지만 완료되지 않음

CUDA OOM 또는 모델 로딩 오류가 있는지 ComfyUI 자체 콘솔을 확인하세요.

확인: Inspect the ComfyUI terminal output

대안

ComfyUI MCP Server 다른 것과 비교

대안언제 쓰나단점/장점
comfy-pilotComfyUI 자체 내에서 Claude가 작업 흐름 초안을 작성할 수 있는 편집기를 원합니다.순수한 MCP 서버가 아닙니다. ComfyUI 노드 설치가 필요합니다
mcp-imageGemini를 통해 설정이 필요 없는 클라우드 생성을 원합니다.이미지당 지불 작업 흐름 유연성이 떨어짐
everart스타일 교육을 받은 클라우드 모델을 원합니다.다른 공급자

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기