MCP Directory

How to add Comfy Pilot to Windsurf

MCP server + embedded terminal that lets Claude Code see, edit, and run your ComfyUI workflows. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 213★ · stdio · no auth

Windsurf config for Comfy Pilot

comfy node install comfy-pilot
{
  "mcpServers": {
    "comfy-pilot": {
      "command": "python3",
      "args": [
        "/path/to/comfy-pilot/mcp_server.py"
      ]
    }
  }
}

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Comfy Pilot config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Comfy Pilot's tools become available to Cascade.

Before you start

  • ComfyUI
  • Python 3.8+
  • Claude Code CLI (installed automatically if not found)

What Comfy Pilot can do in Windsurf

get_workflow

Get the current workflow from the browser.

summarize_workflow

Produce a human-readable workflow summary.

get_node_types

Search available node types with filtering.

get_node_info

Get detailed info about a specific node type.

get_status

Get queue status, system stats, and execution history.

run

Run the workflow (optionally up to a specific node) or interrupt it.

edit_graph

Batch create, delete, move, connect, and configure nodes.

view_image

View images from Preview Image / Save Image nodes.

Security

The plugin runs the Claude Code CLI as a PTY process inside ComfyUI and exposes tools that can edit workflows, install custom nodes, and download models to your machine. The MCP server runs locally over stdio with no authentication; only use it with a ComfyUI instance you trust. The download_model tool can fetch gated Hugging Face models using a token if provided.

Comfy Pilot + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Comfy Pilot config there under the "mcpServers" key and restart the client.

Is Comfy Pilot safe to use with Windsurf?

The plugin runs the Claude Code CLI as a PTY process inside ComfyUI and exposes tools that can edit workflows, install custom nodes, and download models to your machine. The MCP server runs locally over stdio with no authentication; only use it with a ComfyUI instance you trust. The download_model tool can fetch gated Hugging Face models using a token if provided.

How do I install it?

Use the ComfyUI CLI with `comfy node install comfy-pilot`, install via ComfyUI Manager by searching for "Comfy Pilot", or git clone the repo into ComfyUI's custom_nodes folder. Restart ComfyUI afterward.

Do I need to configure the MCP server manually?

No. The plugin auto-configures MCP for Claude Code on startup. If it isn't connecting, you can manually add the comfyui server to ~/.claude.json with command python3 and args pointing to mcp_server.py.

The terminal says 'Command claude not found'. What do I do?

Install the Claude Code CLI. On macOS/Linux/WSL run `curl -fsSL https://claude.ai/install.sh | bash`; on Windows use the PowerShell or CMD installer from claude.ai.

View repo Full Comfy Pilot page