Airflow MCP 服务器

What is Airflow MCP 服务器?

Airflow MCP 服务器是一个与 Apache Airflow 集成的 Model Context Protocol (MCP) 服务器，提供管理和监控 Airflow DAG 运行的工具。它面向需要以标准化协议交互 Airflow 的开发者或自动化工具。

How to use Airflow MCP 服务器？

通过配置 MCP 客户端（如 Claude），在 mcpServers 中添加 airflow 条目，指定命令 uvx 和参数 airflow-mcp，并设置环境变量 AIRFLOW_API_BASE、AIRFLOW_USERNAME 和 AIRFLOW_PASSWORD。也可以使用 uv run 方式在本地开发。

Key features of Airflow MCP 服务器

• 触发指定 DAG（trigger-dag）
• 启用/禁用指定 DAG（enable-dag）
• 获取每日 DAG 运行汇总报告（get-daily-report）
• 列出所有可用 DAG（list-dags）
• 批量获取 DAG 运行记录（list-dag-runs）
• 获取特定 DAG 运行状态（get-dag-status）
• 获取 DAG 运行日志（get-dag-logs）
• 回填指定日期范围的 DAG 数据（backfill-dag）

Use cases of Airflow MCP 服务器

• 通过 MCP 客户端触发 Airflow DAG 并获取运行状态
• 在对话中查看指定时间范围内的 DAG 运行汇总报告
• 批量回填历史数据以修复或重跑管道
• 启用或禁用 DAG 以控制调度
• 通过日志调试特定 DAG 运行失败的原因

FAQ from Airflow MCP 服务器

需要提前安装什么？

需要 Python 环境和 uv 工具（推荐），或者直接使用 uvx 运行。还需一个正在运行的 Apache Airflow 实例。

如何配置 Airflow 连接？

设置环境变量 AIRFLOW_API_BASE（Airflow API 地址，如 http://localhost:8000/api/v1）、AIRFLOW_USERNAME 和 AIRFLOW_PASSWORD。

支持哪些传输协议？

该服务器本身不指定传输协议；它作为 MCP 服务器运行，通过 MCP 客户端（如 Claude）的 stdio 传输进行交互。

认证方式是什么？

使用 Basic Auth，通过 AIRFLOW_USERNAME 和 AIRFLOW_PASSWORD 环境变量配置。

数据存储在哪里？

所有数据通过 Airflow 的 REST API 从配置的 Airflow 实例获取，服务器本身不持久化数据。