> ## Documentation Index
> Fetch the complete documentation index at: https://comfyui-mcp.artokun.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI MCP

> ComfyUI를 위한 로컬 우선, 에이전트 네이티브 컨트롤 플레인 — 자연어로 이미지, 동영상, 오디오를 생성하고 워크플로우를 작성·실행하며 모델과 커스텀 노드를 관리하는 MCP 서버 + Claude Code 플러그인입니다. 로컬, 원격, 또는 Comfy Cloud에서 사용할 수 있습니다.

**ComfyUI MCP**는 [ComfyUI](https://github.com/comfyanonymous/ComfyUI)를 위한 **로컬 우선, 에이전트
네이티브 컨트롤 플레인**입니다 — [MCP](https://modelcontextprotocol.io) 서버이자 Claude Code
플러그인입니다. 실행 중인 ComfyUI 인스턴스 — **로컬**, **원격**, 또는
**[Comfy Cloud](https://cloud.comfy.org)** — 에 AI 어시스턴트를 연결해, 이미지·동영상·오디오를
생성하고, 워크플로우를 실행·작성하고, 모델과 커스텀 노드를 관리하고, 서버를 제어하는 일을 모두
자연어로 할 수 있게 해줍니다. 단순한 프롬프트-투-이미지 브리지가 아니라, ComfyUI를 대신 운영해주는
완전한 에이전트입니다.

<Frame caption="스크린샷 준비 중">
  <img src="https://mintcdn.com/artokun/qVmmygI1ra0_1Zp5/images/placeholder.svg?fit=max&auto=format&n=qVmmygI1ra0_1Zp5&q=85&s=ddf00bbaffc3f29f9f09c8ba46c6b318" alt="작동 중인 ComfyUI MCP — 스크린샷 준비 중" width="1200" height="675" data-path="images/placeholder.svg" />
</Frame>

<CardGroup cols={2}>
  <Card title="빠른 시작" icon="rocket" href="/docs/docs/ko/quickstart">
    Claude Code에 서버를 추가하고 약 2분 만에 첫 이미지를 생성해보세요.
  </Card>

  <Card title="도구 레퍼런스" icon="wrench" href="/docs/docs/tools/image-generation">
    37개 도구, 실시간 스키마로부터 자동 생성된 문서입니다.
  </Card>

  <Card title="설치" icon="download" href="/docs/docs/ko/installation">
    ComfyUI를 설치하고 MCP 서버를 연결하세요 (로컬 또는 원격).
  </Card>

  <Card title="설정" icon="gear" href="/docs/docs/configuration">
    환경 변수, 트랜스포트, 토큰, 원격 타겟팅 설정입니다.
  </Card>
</CardGroup>

## 할 수 있는 일

<CardGroup cols={3}>
  <Card title="생성" icon="image">
    `generate_image`로 텍스트를 이미지로 변환하고, ControlNet과 IP-Adapter 컨디셔닝도 지원합니다.
  </Card>

  <Card title="워크플로우 작성" icon="pen-ruler">
    템플릿으로 생성하고, 수정·검증·시각화하며, 압축 DSL로 왕복 변환합니다.
  </Card>

  <Card title="모델 관리" icon="box">
    HuggingFace/CivitAI에서 검색하고, 모델을 다운로드·조회·삭제합니다.
  </Card>

  <Card title="커스텀 노드" icon="puzzle">
    ComfyUI-Manager를 통해 노드 팩을 설치·업데이트·스냅샷·바이섹트합니다.
  </Card>

  <Card title="설치 및 유지 관리" icon="terminal">
    ComfyUI를 설치·업데이트하고, 환경을 점검하고, 서버를 시작·중지합니다.
  </Card>

  <Card title="로컬, 원격, 또는 클라우드" icon="globe">
    로컬 설치를 자동으로 감지하거나, `--comfyui-url`로 원격을 지정하거나,
    `COMFYUI_API_KEY`로 [Comfy Cloud](https://cloud.comfy.org)와 통신합니다 — 로컬 ComfyUI가
    필요 없습니다.
  </Card>
</CardGroup>

<Note>
  **macOS**, **Linux**, **Windows**에서 동작하며, 로컬 ComfyUI 설치와 포트를 자동으로 감지합니다.
  소스 코드와 이슈는 [GitHub](https://github.com/artokun/comfyui-mcp)에서 확인할 수 있습니다.
</Note>

## 범위: 로컬, 원격, 또는 Comfy Cloud

`comfyui-mcp`는 **로컬**과 **원격** ComfyUI를 위한 커뮤니티 MCP입니다 — 이것이 주요 대상입니다
(Mac/Linux/Windows 설치, RunPod, VPS, LAN 등).

**Comfy Cloud** 사용자를 위해 Comfy-Org는 Comfy 팀이 유지 관리하며 Comfy Cloud에서 실행되는
[공식 에이전트 툴링](https://docs.comfy.org/agent-tools) — Comfy Cloud MCP(퍼블릭 베타)와
Comfy In-App Agent(프라이빗 알파) — 을 제공합니다. GPU가 없거나 설정을 전혀 하고 싶지 않다면
이를 사용하세요 ([나란히 비교](/docs/docs/local-vs-comfy-cloud)). `comfyui-mcp`에도 커뮤니티 클라우드
모드(`COMFYUI_API_KEY`)가 포함되어 있어, 하나의 MCP로 세 가지 배포 형태를 모두 하나의 설정에서
대상으로 삼을 수 있습니다 — 본인의 작업 방식에 맞는 것을 고르세요.

***

## 메인테이너

[**@artokun**](https://github.com/artokun)이 개발하고 유지 관리합니다 —
[Comfy-Org/ComfyUI\_frontend](https://github.com/Comfy-Org/ComfyUI_frontend/pulls?q=is%3Apr+author%3Aartokun)
(v2 그래프 렌더러 / 서브그래프 렌더링 / 승격된 위젯)와
[ComfyUI Python 코어](https://github.com/Comfy-Org/ComfyUI/pulls?q=is%3Apr+author%3Aartokun)에
꾸준히 기여하고 있습니다.

**Comfy-Org 관계자분들**(또는 ComfyUI 생태계에서 채용 중이신 분):
[art.longbottom.jr@gmail.com](mailto:art.longbottom.jr@gmail.com).