airflow-mcp-server
@us-all/airflow-mcp
Airflow MCP-Server — DAGs, Runs, Task-Instanzen und Log-Tails lesen; Trigger und Clear (schreibgeschützt). Basiert auf
@us-all/mcp-toolkit.
Ein fokussierter MCP für die Airflow Stable REST API. Standardmäßig nur lesend; airflow-trigger-dag und airflow-clear-task sind durch AIRFLOW_ALLOW_WRITE=true geschützt.
Für eine tiefere dbt-Integration (Manifest-Parsing, Run-Results-Historie, Source-Freshness, spaltenbasierte Testabdeckung, Lineage-Analysen, benutzerdefinierte DQ-Ergebnistabellen) installieren Sie zusätzlich den Begleiter @us-all/dbt-mcp.
7 Tools in den Kategorien
airflow+meta2 MCP-Prompts für DAG-Triage-Workflows
1 Aggregations-Tool, das die Kombination aus list-runs → get-task-instances ersetzt
Installation
pnpm add -D @us-all/airflow-mcpRelated MCP server: Apache Airflow MCP Server
Ausführung
AIRFLOW_API_URL=http://airflow.example.com:8080/api/v1 \
AIRFLOW_USERNAME=admin AIRFLOW_PASSWORD=... \
npx @us-all/airflow-mcpDer Server spricht MCP stdio; binden Sie ihn in Claude Desktop / Cursor / einen beliebigen MCP-Client ein. Setzen Sie MCP_TRANSPORT=http, um den Streamable HTTP-Transport (Bearer-Auth, /health-Endpunkt) zu aktivieren.
Tools
airflow (6 + 1 Aggregation)
Tool | Beschreibung |
| Aktive DAGs mit Tag-/Suchfiltern auflisten |
| Letzte Runs eines DAGs (Statusfilter, sortiert nach Aktualität) |
| Task-Instanzen für einen spezifischen DAG-Run |
| Tail (letzte N kB) eines Task-Instanz-Logs |
| Einen neuen Run auslösen (schreibgeschützt) |
| Spezifische Task-Instanzen löschen → erneut ausführen (schreibgeschützt) |
| Aggregierter DAG-Status: Erfolgsrate + durchschnittliche Dauer + letzter fehlgeschlagener Run + fehlerhafte Tasks |
meta
search-tools — natürlichsprachliche Tool-Suche.
Prompts
Prompt | Verwendung bei |
| "Warum ist DAG X fehlgeschlagen?" — ruft Runs ab, isoliert Fehler, gibt Logs aus, schlägt Korrekturen vor |
| "Alle DAGs auf niedrige Erfolgsraten und hängende Runs prüfen" |
Umgebungsvariablen
Env | Erforderlich | Hinweise |
| ja | Airflow REST API Basis, z. B. |
| nein | Basic-Auth Benutzername |
| nein | Basic-Auth Passwort (geheim) |
| nein |
|
| nein | Kategorie-Umschalter |
Getestete Schemata
Airflow Stable REST API (2.x). Airflow 3.x stellt dieselbe Schnittstelle über die
/api/v1/Stable-Endpunkte bereit, daher funktioniert dieser Server sowohl mit 2.x- als auch mit 3.x-Deployments.
Begleitender Server
Für dbt-Artefakt-Parsing, Run-Results-Historie und DQ-Ergebnistabellen installieren Sie zusätzlich @us-all/dbt-mcp.
Build
pnpm install
pnpm run build # tsc → dist/
pnpm test # vitest
pnpm run smoke # spawns dist/index.js, calls initialize + tools/list (set env first)Lizenz
MIT — siehe LICENSE.
Available Tools
8 toolsairflow-clear-taskA
Clear specific task instances in an Airflow DAG run (re-run them); supports include_upstream / include_downstream. Write-gated by AIRFLOW_ALLOW_WRITE.
Inputs: dagId (required), dagRunId (required), taskIds (required), includeDownstream, +1 more.
airflow-get-task-instancesB
List task instances for a specific Airflow DAG run with state, try_number, duration
Inputs: dagId (required), dagRunId (required), extractFields.
airflow-get-task-logsB
Fetch the tail (last N kB) of an Airflow task instance log for a specific try_number
Inputs: dagId (required), dagRunId (required), taskId (required), tryNumber, +2 more.
airflow-list-dagsB
List Airflow DAGs (active by default) with optional tag filter and dag_id substring search
Inputs: onlyActive, tag, search, limit, +1 more.
airflow-list-runsA
List recent runs of one Airflow DAG, optionally filtered by state, ordered newest first
Inputs: dagId (required), state, limit, extractFields.
airflow-trigger-dagA
Trigger a new Airflow DAG run with optional conf payload and note. Write-gated by AIRFLOW_ALLOW_WRITE.
Inputs: dagId (required), dagRunId, conf, note, +1 more.
dag-health-rollupA
Aggregated DAG health: success-rate over the last N runs + count breakdown (succeeded/failed/queued) + average duration + last-failed-run id + (optional) failing task instances. Replaces the airflow-list-runs + airflow-get-task-instances combo for 'is this DAG healthy right now?'.
Inputs: dagId (required), recentRuns, includeFailingTasks, extractFields.
search-toolsA
Discover available Airflow MCP tools by natural language query.
Inputs: query (required), category, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool maps to a distinct resource/action: DAGs, runs, task instances, logs, aggregate health, and tool discovery. dag-health-rollup and airflow-list-runs could overlap for health questions, but the description explicitly positions the rollup as the higher-level replacement, so ambiguity remains low.
Most tools follow the airflow-<verb>-<object> pattern (airflow-list-dags, airflow-trigger-dag, airflow-clear-task, airflow-list-runs, airflow-get-task-instances, airflow-get-task-logs), but dag-health-rollup and search-tools break both the airflow- prefix and the verb-noun convention. There is also minor inconsistency between 'list' and 'get' for similar retrieval operations.
Eight tools is well-scoped for an Airflow operations server. Each tool covers a meaningful operation without redundancy or bloat.
The set covers the core operational workflow: discover DAGs, trigger runs, inspect runs/task instances/logs, clear tasks, and get an aggregated health rollup. Minor gaps like pause/unpause DAGs or fetching DAG details exist, but they do not break the primary monitoring and troubleshooting use case.
Maintenance
Related MCP Connectors
Official Airtable MCP server — database and operations layer for agents.
Streamable HTTP MCP server exposing planner flows, tasks, and squads.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Argentic MCP server: run and inspect long-running agents on Argentic.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables inspection and management of Apache Airflow DAGs, runs, and logs across multiple instances. It provides tools for monitoring workflows and performing gated write operations like triggering DAGs or clearing task instances.1673 PyPI2Apache 2.0
- AlicenseNot gradedqualityNot gradedmaintenanceAn MCP server that wraps the Apache Airflow REST API, enabling clients to manage DAGs, monitor task instances, and handle workflows through a standardized interface. It provides comprehensive access to Airflow features including DAG runs, variables, connections, and XComs.MIT
- AlicenseAqualityCmaintenanceMCP server exposing Apache Airflow REST API operations as tools — list DAGs, inspect runs and task instances, trigger DAG runs, and check failed DAGs and scheduler health72MIT
- FlicenseNot gradedqualityDmaintenanceEnables DAG management, monitoring, debugging, and connection testing for Apache Airflow through the MCP protocol.-