runcomfy-mcp
Remote MCP server for the RunComfy Serverless API (ComfyUI)
Documentation
RunComfy MCP
MCP server for the RunComfy Serverless API (ComfyUI). Manage deployments, run inference, and retrieve results from AI assistants like Claude, Cursor, and Windsurf.
Website: www.runcomfy.com
Endpoint: `https://mcp.runcomfy.com/mcp`
Docs: docs.runcomfy.com/mcp
What it does
10 tools that mirror docs.runcomfy.com/serverless 1:1:
| Category | Tools |
|---|---|
| Deployment management | `list_deployments`, `get_deployment`, `create_deployment`, `update_deployment`, `delete_deployment` |
| Inference | `submit_request`, `get_request_status`, `get_request_result`, `cancel_request` |
| Advanced | `call_instance_proxy` |
Quick setup
Claude Code
claude mcp add runcomfy \
--transport streamable-http \
https://mcp.runcomfy.com/mcp \
--header "Authorization: Bearer "Cursor
Add to `.cursor/mcp.json`:
{
"mcpServers": {
"runcomfy": {
"url": "https://mcp.runcomfy.com/mcp",
"headers": {
"Authorization": "Bearer "
}
}
}
}Windsurf
Add to Windsurf Settings > MCP:
{
"mcpServers": {
"runcomfy": {
"serverUrl": "https://mcp.runcomfy.com/mcp",
"headers": {
"Authorization": "Bearer "
}
}
}
}Get your API token from your Profile page.
Architecture
MCP Client ──Bearer token──> Cloudflare Worker (/mcp)
│
▼
Cloudflare Container
(Python FastMCP app)
│
▼
api.runcomfy.net
(using caller's token)- Cloudflare Worker (`src/index.ts`) — thin proxy: CORS, body size check, forwards the caller's token to the container. No auth logic — `api.runcomfy.net` handles authentication.
- Python container (`server.py`) — FastMCP app with 10 tools. Uses the caller's token (forwarded via `x-runcomfy-user-token` header) for all outbound API calls. Each user sees only their own deployments.
- Cloudflare Container auto-starts on first request, sleeps after 10 minutes idle.
Project layout
src/index.ts Cloudflare Worker entrypoint
server.py MCP tool definitions (10 tools)
runcomfy_client.py RunComfy API client (serverless endpoints)
container_app.py ASGI middleware (request IDs, token forwarding)
container_entrypoint.py Uvicorn startup
container_runtime.py Env validation, structured logging
wrangler.jsonc Cloudflare Worker + Container config
Dockerfile Container image
.env.example Local dev configLocal development
# Python 3.11+
python3.11 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# Set RUNCOMFY_API_KEY in .env
python -m container_entrypointLocal endpoints:
- `http://127.0.0.1:8000/healthz`
- `http://127.0.0.1:8000/mcp`
In local mode (no Worker), the Python app uses `RUNCOMFY_API_KEY` from `.env` for all outbound calls.
Deploy
Requires Cloudflare Workers Paid plan with Containers enabled.
npm install
# Set the API key secret (one-time)
npx wrangler secret put RUNCOMFY_API_KEY
# Deploy
CLOUDFLARE_ACCOUNT_ID= npx wrangler deployThe MCP endpoint goes live at `https://mcp.runcomfy.com/mcp` (custom domain configured in `wrangler.jsonc`).
Environment variables
Worker secrets (set via `wrangler secret put`)
| Name | Required | Description |
|---|---|---|
| `RUNCOMFY_API_KEY` | Yes | Fallback API key for the container |
Worker vars (in `wrangler.jsonc`)
| Name | Default | Description |
|---|---|---|
| `CONTAINER_INSTANCE_NAME` | `runcomfy-unified` | Durable Object instance name |
| `CONTAINER_STARTUP_TIMEOUT_MS` | `15000` | Max wait for container start |
| `CONTAINER_PORT_READY_TIMEOUT_MS` | `30000` | Max wait for port ready |
| `MCP_MAX_BODY_BYTES` | `1048576` | Max request body size |
| `RUNCOMFY_SERVERLESS_BASE_URL` | `https://api.runcomfy.net` | Serverless API base URL |
Local dev (`.env` file)
| Name | Required | Description |
|---|---|---|
| `RUNCOMFY_API_KEY` | Yes | Your RunComfy API token |
| `RUNCOMFY_SERVERLESS_BASE_URL` | No | Override base URL (default: `https://api.runcomfy.net`) |
| `RUNCOMFY_MCP_MOUNT_PREFIX` | No | Path prefix for MCP mount (default: empty) |
Frequently asked questions
What is runcomfy-mcp?
runcomfy-mcp is Remote MCP server for the RunComfy Serverless API (ComfyUI)
How do I install runcomfy-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is runcomfy-mcp open source?
Yes — it is hosted on GitHub at https://github.com/runcomfy-com/runcomfy-mcp.
Related MCP tools
Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.
Fast and Accurate Code Search for Agents. Uses 99% fewer tokens than grep+read
An AI Gateway, registry, and proxy that sits in front of any MCP, A2A, or REST/gRPC APIs, exposing a unified endpoint with centralized discovery, guardrails and management. Optimizes Agent & Tool calling, and supports plugins.
Control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search & Drive with AI - Comprehensive Google Workspace MCP Server & CLI Tool
Cut AI token costs 95%+ on code exploration. The leading MCP server for precise, symbol-level GitHub code retrieval via tree-sitter AST. Works with Claude Code, Cursor & any MCP client. 313B+ tokens saved.
MCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP