Release v0.3.0

🎉 v0.3.0 - First Release

We're excited to announce the first official release of dolphin-mcp-pilot — a production-ready MCP server that lets AI agents truly operate Apache DolphinScheduler.

This isn't another read-only demo. With 53+ tools covering real-world operations, dolphin-mcp-pilot empowers AI agents to create workflows, manage schedules, control instances, and handle everything in between.

✨ What's Included

Core Capabilities

• 53+ Production Tools — Comprehensive coverage of DolphinScheduler operations: projects, workflows, DAGs, schedules, instances, resources, logs, and monitoring
• Workflow Creation — One-line SQL and complex DAG workflow creation with multiple task types
• Schedule Management — Full lifecycle control: create, online, offline, delete with cron-based scheduling
• Instance Lifecycle — Pause, resume, rerun, rerun-from-failure, and delete process instances

Developer Experience

• Dual Authentication Modes — API Token (X-DS-Token) or User/Password (X-DS-User + X-DS-Password) flexibility
• Multi-Tenant HTTP Support — Each caller uses its own credentials, perfect for production deployments
• Raw API Passthrough — Safety valve for uncovered edge cases and advanced scenarios
• Docker Compose Ready — Dev and prod profiles with one-command startup

Intelligence & UX

• Guided Troubleshooting — ds_list_process_instances attaches next_action hints, pointing agents to the right diagnostic tools
• Reliable Backfill Ordering — Serial complement uses proper date range format for strict day-by-day instance generation
• Flexible Task Parameters — Accepts both snake_case and camelCase field names with ignored field reporting

Resource Management

• Content Management — View and update resource content directly
• Version Control — Roll back workflow versions and clone workflows
• Task Debugging — View task logs, force task success, skip failed tasks

Documentation & Community

• Comprehensive Docs — Installation, configuration, deployment, features, client config, API reference, and FAQ
• Multi-Language Support — Documentation in both English and 简体中文
• Client Integration Guides — Setup instructions for CodeBuddy, Claude Desktop, and other MCP clients
• Open Source — Apache 2.0 license with clear contribution guidelines

🚀 Quick Start

# Clone the repository
git clone https://github.com/iflytek/dolphin-mcp-pilot.git
cd dolphin-mcp-pilot

# Configure environment
cp .env.example .env
# Edit .env — set DS_URL and DS_TOKEN (or DS_USER/DS_PASSWORD)

# Start the service
docker compose --profile dev up -d dolphin-mcp-pilot-dev

✅ Service available at http://localhost:8001/mcp/

👥 Contributors

A huge thank you to our founding contributors:

• @dongjiang1989 @jhliao2 — Core development and architecture
• @FenjuFu — Feature development and improvements
• @dependabot[bot] — Automated dependency management
• Built with FastMCP and inspired by the Apache DolphinScheduler community

Full Changelog: https://github.com/iflytek/dolphin-mcp-pilot/commits/v0.3.0
Documentation: https://github.com/iflytek/dolphin-mcp-pilot#readme