ComfyUI MCP 서버

Name: ComfyUI MCP Server
Author: Overseer66

1. 개요

ComfyUI를 MCP와 통합하기 위한 서버 구현.
⚠️ 중요: 이 서버에는 ComfyUI 서버가 실행 중이어야 합니다.
- 자신의 ComfyUI 서버를 호스팅해야 합니다.
- 또는 기존 ComfyUI 서버 주소에 액세스할 수 있습니다.

지엑스피1

mcp dev src/server.py

src/.env 편집하여 ComfyUI 호스트와 포트를 설정합니다.
COMFYUI_HOST=localhost COMFYUI_PORT=8188

텍스트를 이미지로
- 생성된 이미지의 URL만 반환합니다.
- 실제 이미지를 얻으려면:
  - download_image 도구를 사용하거나
  - 브라우저에서 URL에 직접 접근하세요.
다운로드_이미지
- 이미지 URL을 사용하여 다른 도구(예: text_to_image )에서 생성된 이미지를 다운로드합니다.
파일과 함께 워크플로 실행
- 워크플로 JSON 파일의 경로를 제공하여 워크플로를 실행합니다.
  # You should ask to agent like this. Run comfyui workflow with text_to_image.json
- CursorAI의 예시 이미지
json으로 워크플로 실행
- 워크플로 JSON 데이터를 직접 제공하여 워크플로를 실행합니다.
  # You should ask to agent like this. Run comfyui workflow with this { "3": { "inputs": { "seed": 156680208700286, "steps": 20, ... (workflow JSON example) }

예시 mcp.json :
{ "mcpServers": { "comfyui": { "command": "uv", "args": [ "--directory", "PATH/MCP/comfyui", "run", "--with", "mcp", "--with", "websocket-client", "--with", "python-dotenv", "mcp", "run", "src/server.py:mcp" ] } } }

download_image 사용하여 로컬 폴더에 이미지를 다운로드하는 것은 Docker 컨테이너가 호스트 파일 시스템을 공유하지 않기 때문에 어려울 수 있습니다.
Docker를 사용할 때 다음 사항을 고려하세요.
1. .env 에서 RETURN_URL=false 설정하여 이미지 데이터를 바이트로 받습니다.
2. .env 에서 COMFYUI_HOST 적절한 주소(예: host.docker.internal 또는 서버의 IP)로 설정합니다.
3. 참고: 이진 데이터를 사용하면 대용량 이미지 페이로드가 응답 한도를 초과할 수 있습니다.

# First build image docker image build -t mcp/comfyui .

{ "mcpServers": { "comfyui": { "command": "docker", "args": [ "run", "-i", "--rm", "-p", "3001:3000", "mcp/comfyui" ] } } }

미리 만들어진 이미지를 사용할 수도 있습니다.

{ "mcpServers": { "comfyui": { "command": "docker", "args": [ "run", "-i", "--rm", "-p", "3001:3000", "overseer66/mcp-comfyui" ] } } }

Docker로 SSE 서버를 실행합니다.
docker run -i --rm -p 8001:8000 overseer66/mcp-comfyui-sse
mcp.json 구성합니다(필요한 경우 localhost를 IP 또는 도메인으로 변경합니다):
{ "mcpServers": { "comfyui": { "url": "http://localhost:8001/sse" } } }