Skip to main content
Glama
airflow-mcp-server

airflow-mcp-server

by us-all

@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 + meta

  • 2 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-mcp

Related 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-mcp

Der 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

airflow-list-dags

Aktive DAGs mit Tag-/Suchfiltern auflisten

airflow-list-runs

Letzte Runs eines DAGs (Statusfilter, sortiert nach Aktualität)

airflow-get-task-instances

Task-Instanzen für einen spezifischen DAG-Run

airflow-get-task-logs

Tail (letzte N kB) eines Task-Instanz-Logs

airflow-trigger-dag

Einen neuen Run auslösen (schreibgeschützt)

airflow-clear-task

Spezifische Task-Instanzen löschen → erneut ausführen (schreibgeschützt)

dag-health-rollup

Aggregierter DAG-Status: Erfolgsrate + durchschnittliche Dauer + letzter fehlgeschlagener Run + fehlerhafte Tasks

meta

search-tools — natürlichsprachliche Tool-Suche.

Prompts

Prompt

Verwendung bei

dag-failure-triage

"Warum ist DAG X fehlgeschlagen?" — ruft Runs ab, isoliert Fehler, gibt Logs aus, schlägt Korrekturen vor

dag-schedule-audit

"Alle DAGs auf niedrige Erfolgsraten und hängende Runs prüfen"

Umgebungsvariablen

Env

Erforderlich

Hinweise

AIRFLOW_API_URL

ja

Airflow REST API Basis, z. B. http://airflow.example.com:8080/api/v1

AIRFLOW_USERNAME

nein

Basic-Auth Benutzername

AIRFLOW_PASSWORD

nein

Basic-Auth Passwort (geheim)

AIRFLOW_ALLOW_WRITE

nein

true aktiviert airflow-trigger-dag / airflow-clear-task

AIRFLOW_TOOLS / AIRFLOW_DISABLE

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 tools
airflow-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

    A3.6/5.0

    Scored across 8 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    Eight tools is well-scoped for an Airflow operations server. Each tool covers a meaningful operation without redundancy or bloat.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      16
      73 PyPI
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An 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