
Apache DolphinScheduler(小海豚)生产准备MCP服务器——允许AI代理构建、调度、运行和恢复工作流程
概览
一个适用于Apache DolphinScheduler(小海豚)的生产准备MCP服务器。 这些文件涵盖项目、工作流、DAG创建、调度、实例、资源、日志、监控和原始API直通——专为需要操作Dolphin调度器超出基本只读功能的AI代理设计。 大多数公共的 DolphinScheduler MCP 服务器只支持基本的读/列/启动/停止场景。本项目设计用于: - ✅ 一行创建SQL / DAG工作流 - ✅ 管理计划(创建/在线/离线/删除)- ✅ 控制进程实例(暂停/恢复/重运行/从失败中重跑)- ✅ 查看任务日志,强制任务成功/跳过失败任务 - ✅ 管理资源(查看/更新内容)- ✅ 回滚工作流版本,克隆工作流 - ✅ 使用原始API作为安全阀 - ✅ 支持 - 涵盖大多数实用的DS操作 - :API令牌(X-DS-Token)或用户/密码(X-DS-User + X-DS-Password)- 每个调用者可以使用自己的凭证 - 并自动兼容MCP 1。
概述(AI 翻译)
英文 |简体中文
一个适用于Apache DolphinScheduler(小海豚)的生产准备MCP服务器。
dolphin-mcp-pilot 提供 53+ 工具,用于项目、工作流、DAG 创建、调度、实例、资源、日志、监控和原始 API 直通——专为需要操作 DolphinScheduler 超出基本只读功能的 AI 代理设计。
🎯 为什么是这个项目?
大多数公共的DolphinScheduler MCP服务器只支持基本的读/列表/启动/停止场景。 本项目专为实际运营工作设计:
- ✅ 一行创建 SQL / DAG 工作流程
- ✅ 管理日程(创建/在线/离线/删除)
- ✅ 控制进程实例(暂停/恢复/重运行/从故障重运行)
- ✅ 查看任务日志,强制任务成功/跳过失败任务
- ✅ 管理资源(查看/更新内容)
- ✅ 回滚工作流程版本,克隆工作流程
- ✅ 使用原始API作为安全阀
- ✅ 支持 多租户每请求认证
🚀 主要特征
- 53+ 工具,涵盖大多数实用的DS操作
- 两种认证模式:API令牌(
X-DS-Token)或用户/密码(X-DS-User+X-DS-Password) - 多租户HTTP模式:每个呼叫者可以使用自己的凭证
- **MCP 2。
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
dolphin-mcp-pilot
A production-ready MCP server for Apache DolphinScheduler (小海豚).
dolphin-mcp-pilot exposes 53+ tools for projects, workflows, DAG creation, schedules, instances, resources, logs, monitoring and raw API passthrough — designed for AI agents that need to operate DolphinScheduler beyond basic read-only usage.
🎯 Why this project?
Most public DolphinScheduler MCP servers only cover basic read/list/start/stop scenarios. This project is designed for real operations work:
- ✅ Create SQL / DAG workflows in one line
- ✅ Manage schedules (create / online / offline / delete)
- ✅ Control process instances (pause / resume / rerun / rerun-from-failure)
- ✅ View task logs, force task success / skip failed task
- ✅ Manage resources (view/update content)
- ✅ Roll back workflow versions, clone workflows
- ✅ Use raw API as a safety valve
- ✅ Support multi-tenant per-request auth
🚀 Key features
- 53+ tools covering most practical DS operations
- Two auth modes: API Token (
X-DS-Token) or User/Password (X-DS-User+X-DS-Password) - Multi-tenant HTTP mode: each caller can use its own credentials
- MCP 2.0 stateless HTTP with automatic compatibility for MCP 1.x clients
- Workflow creation: simple SQL and complex DAG workflows with multiple task types
- Schedule management (cron-based)
- Instance lifecycle control (pause/resume/rerun/rerun-from-failure/delete)
- Resource content management and version rollback / workflow clone
- Raw API passthrough for uncovered edge cases
🚀 Quick Start
Prerequisites
- A running DolphinScheduler 3.x instance whose API is reachable from Docker
- Docker with Compose v2 (
docker compose version) - A DolphinScheduler API token (recommended), or a username and password
# 1. Clone the repository
git clone https://github.com/iflytek/dolphin-mcp-pilot.git
cd dolphin-mcp-pilot
# 2. Configure environment
cp .env.example .env
# Edit .env — set DS_URL and DS_TOKEN (or DS_USER/DS_PASSWORD)
# Example DS_URL: http://your-dolphinscheduler-host:12345/dolphinscheduler
# 3. Build and start the service from this checkout
docker compose --profile dev up -d dolphin-mcp-pilot-dev
# 4. Confirm that the container is healthy
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"dolphinscheduler": {
"type": "sse",
"url": "http://localhost:8001/mcp/",
"headers": { "X-DS-Token": "your_api_token" }
}
}
}