artokun/comfyui-mcp

해결하는 문제

comfyui-mcp는 ComfyUI를 위한 포괄적인 제어 플레인을 제공하여, 어떤 LLM을 사용하든 자연어를 통해 노드 기반의 생성형 AI 인터페이스를 제어할 수 있게 합니다. 단순한 프롬프트 전달을 넘어서, AI 에이전트가 실제로 ComfyUI 환경을 운영할 수 있도록 하여, 렌더링을 트리거하는 것 이상으로 워크플로우, 모델, 사용자 정의 노드를 작성하고 편집하며 관리할 수 있게 합니다.

작동 방식

이 프로젝트는 LLM(Claude, ChatGPT, Gemini, Ollama를 통한 로컬 모델 등)과 ComfyUI 설치 간의 다리 역할을 하는 Model Context Protocol (MCP) 서버를 구현합니다. 로컬 설치, LAN, VPS, Comfy Cloud 모두에 대응 가능합니다.

주요 구성 요소:

• MCP 서버: LLM에 워크플로우 실행 및 그래프 조작을 위한 38개의 도구를 노출하는 독립형 서버.
• 에이전트 패널: ComfyUI용 사이드바 확장 기능으로, 자율 에이전트가 실시간으로 라이브 캔버스를 제어할 수 있게 합니다.
• Claude Code 플러그인: Claude Code 환경에 특화된 슬래시 명령어, 자율 에이전트(탐색자, 디버거, 최적화기, 연구자), 그리고 훅(예: VRAM 워치독)을 추가합니다.
• 스킬 팩: 특정 모델 패밀리(Flux, WAN, LTX 2.3 등)를 위한 통합 전문 지식으로, 시도 오류 없이 올바른 샘플러, CFG, 해상도를 제공합니다.

대상 사용자

ComfyUI를 사용하고 복잡한 워크플로우 자동화, 오류 진단, 환경 관리를 AI 어시스턴트를 통해 다양한 배포 형태(로컬 GPU, 원격 포드, 클라우드)에서 원하는 생성형 AI 아티스트 및 개발자.

주요 특징

• 완전한 그래프 제어: 자연어로 라이브 ComfyUI 그래프를 노드 단위로 편집 가능.
• 다중 LLM 지원: Claude, ChatGPT, Gemini, Ollama, OpenAI 호환 엔드포인트와 호환.
• 자율 에이전트: 워크플로우 실패 디버깅 및 VRAM 사용량 최적화를 위한 전용 에이전트 포함.
• 모델 전문성: 13개 이상의 모델 패밀리용 커리레이티드 가이드 및 설치 팩을 제공하여 고품질 생성 보장.
• 원격 오케스트레이션: 보안 터널을 통해 로컬 머신에서 원격 ComfyUI 인스턴스 제어 가능.
• VRAM 워치독: 요청된 작업에 GPU 메모리가 부족할 경우 사전 실행 훅으로 사용자에게 경고.