What You Can Do

Works with Claude Desktop, Cursor, Windsurf, VS Code (Continue/Cline), Claude Code, and any MCP-compatible client.

Just ask in natural language:

| What you want | Say this to Claude | |---------------|-------------------| | List workflows | "Show my flows" | | Create a workflow | "Create a flow: text input → buffer → preview" | | Run a workflow | "Run flow 1004897" | | Check results | "Show the preview node output" | | Visualize | "Show graph for 1004897" | | Rename a node | "Rename node 1009369 to EurekaFlow" | | Add a node | "Add a text input block to this flow" | | Connect nodes | "Connect the input node to the buffer" | | Clean up | "Delete disconnected nodes" |

No code required. No tool names to remember. Just ask in natural language.

Quick Start

Step 1: Install

npm install -g @lemoncloud/flow-mcp

Step 2: Get an API Key

Get your API key from Eureka Codes Console.

Step 3: Configure Your MCP Client

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "flow-mcp": {
      "command": "npx",
      "args": ["-y", "@lemoncloud/flow-mcp"],
      "env": {
        "FLOW_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor / Windsurf — add the same mcpServers config to your IDE's MCP settings.

Step 4: Go!

Restart your client and say "Show my flows".

Note: Only FLOW_API_KEY is required. API URL has a sensible default.

Configuration

| Variable | Required | Default | Description | |----------|:--------:|---------|-------------| | FLOW_API_KEY | Yes | — | API authentication key | | FLOW_API_URL | | https://api.eureka.codes/flw-v1 | API server URL | | FLOW_API_TIMEOUT | | 30000 | Request timeout (ms) | | FLOW_WS_URL | | wss://wss.eureka.codes/wss-v1 | WebSocket URL for real-time execution monitoring |

Examples

Create & Run

"Show available blocks"
→ Lists input / process / output block types

"Create a flow with text input, 3s buffer, and preview connected together"
→ Creates 3 nodes + 2 edges automatically

"Run the flow"
→ Shows real-time progress → returns results

Modify Existing Flows

"Load flow 1004897"
→ Shows nodes, edges, port data

"Change the input text to Hello Eureka"
→ Updates config.text

"Add another output block and connect it"
→ Creates node + edge

"Show graph"
→ Mermaid diagram

Inspect Results

"Run the whole flow"
→ Per-node progress + completion status

"What's the preview node output?"
→ Port data (value, type, timestamp)

23 Tools

Claude automatically selects the right tool based on your request.

| Tool | What it does | |------|-------------| | profile_get | Check API key configuration status | | block_list | List available block types | | block_get | Get block details by ID or name | | flow_list | List your workflows (with pagination) | | flow_load | Load full flow state (nodes, edges, ports) | | flow_graph | Mermaid diagram visualization | | flow_create | Create new flow (nodes + edges at once) | | flow_update | Update flow name / description | | flow_save | Full rebuild (caution: reassigns node IDs) | | flow_clone | Duplicate a flow | | flow_export | Export flow as portable JSON | | flow_run | Execute flow + real-time monitoring | | flow_run_from | Run flow from a specific node | | node_get | Get single node details | | node_create | Add node to existing flow | | node_run | Execute single node | | node_get_port | Inspect node input/output data | | node_update | Update node config / label / position | | node_delete | Delete a node | | edge_create | Connect two nodes | | edge_delete | Remove a connection | | run_list | List execution history with token usage | | run_get | Get execution run details |

Build from Source

git clone https://github.com/lemoncloud-io/flow-mcp.git
cd flow-mcp
npm install
npm run build

Commands

| Command | Description | |---------|-------------| | npm run build | TypeScript compilation | | npm run dev | Watch mode | | npm run lint | ESLint | | npm run lint:type | Type check (tsc --noEmit) | | npm run format | Prettier format | | npm start | Run MCP server (stdio) | | npm test | Run tests |

Local Build Config

{
  "mcpServers": {
    "flow-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/flow-mcp/dist/stdio.js"],
      "env": {
        "FLOW_API_KEY": "your-api-key",
        "FLOW_WS_URL": "wss://wss.eureka.codes/wss-v1"
      }
    }
  }
}

Architecture

stdio.ts (console suppression + JSON-RPC filter)
  -> server.ts (McpServer + 23 tools)
    -> tools/*.ts (tool handlers)
      -> api-client.ts (Axios -> flows-api REST)
      -> ws-client.ts (WebSocket -> real-time execution events)
      -> config.ts (Zod v4 env validation)

WebSocket Execution Flow

1. Connect WS (info= param -> connectionId)
2. Trigger run (POST /nodes/:id/run?connection=<connId>)
3. Monitor events (node status + port updates)
4. Settle on completion (all terminal) or quiet period (1.5s)
5. Return result with full event log

Publish

npm run build
npm publish --access public

Related Projects

• Eureka Flow — Visual workflow editor (frontend)

License

Apache-2.0 -- LemonCloud