dolphin-mcp-pilot — Claude Code MCP server: install and features
Controls Apache DolphinScheduler pipelines through AI agents: build DAGs, schedule runs, inspect failed task logs, and resume failed jobs.
Open on GitHubWhat dolphin-mcp-pilot does
The server gives models over 53 operational tools for Apache DolphinScheduler. Agents can generate SQL tasks, assemble multi-node graphs, inspect execution logs, and roll back workflow definitions. It handles scheduling via cron, along with workflow pausing, resuming, and rerunning failed nodes.
The service starts inside Docker via docker compose --profile dev up -d dolphin-mcp-pilot-dev. It exposes an SSE endpoint on port 8001. Two authentication methods are available: an X-DS-Token header or username and password credentials. Each caller can pass its own headers in multi-tenant setups.
A reachable DolphinScheduler 3.x instance is strictly required. Without network access to the scheduler API, operations will fail immediately.
What it helps with
- inspect error logs for failing execution steps
- build and activate scheduled DAG workflows
- rerun failed pipeline executions from the failure point
- trigger ordered historical data backfills across date ranges
Example prompts for the agent
- Create a daily SQL workflow, configure its cron schedule, and display the plan.
- Run a sequential data backfill from 2026-08-01 through 2026-08-07 starting at the validation task.
How to install dolphin-mcp-pilot
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about dolphin-mcp-pilot
How to install dolphin-mcp-pilot in Claude Code?
Clone the repository, configure .env with your instance URL, and run docker compose --profile dev up -d dolphin-mcp-pilot-dev. Then register an SSE server pointing to http://localhost:8001/mcp/ with your X-DS-Token header.
What does dolphin-mcp-pilot do?
It connects AI agents to Apache DolphinScheduler using 53+ tools. The agent can build workflows, track jobs, review task logs, and trigger retries.
What are the prerequisites for running this server?
You need Docker with Compose v2 and a working DolphinScheduler 3.x instance reachable by network. Authentication requires either an API token or a username and password.
