@us-all/airflow-mcp

Airflow MCPサーバー — DAG、実行、タスクインスタンス、ログテールの読み取り。トリガーおよびクリア（書き込み制限付き）。@us-all/mcp-toolkit を基盤として構築されています。

Airflow Stable REST APIに特化したMCPです。デフォルトでは読み取り専用ですが、AIRFLOW_ALLOW_WRITE=true を設定することで airflow-trigger-dag および airflow-clear-task が有効になります。

dbtとのより深い統合（マニフェスト解析、実行結果履歴、ソースの鮮度、列ごとのテストカバレッジ、リネージの追跡、カスタムDQ結果テーブルなど）が必要な場合は、コンパニオンである @us-all/dbt-mcp を併せてインストールしてください。

• airflow + meta カテゴリで7つのツールを提供

• DAGトリアージワークフロー用の2つのMCPプロンプト

• list-runs → get-task-instances の組み合わせを置き換える1つの集約ツール

インストール

pnpm add -D @us-all/airflow-mcp

実行

AIRFLOW_API_URL=http://airflow.example.com:8080/api/v1 \
AIRFLOW_USERNAME=admin AIRFLOW_PASSWORD=... \
npx @us-all/airflow-mcp

このサーバーはMCP stdioを使用します。Claude Desktop / Cursor / その他のMCPクライアントに接続してください。MCP_TRANSPORT=http を設定すると、ストリーミング可能なHTTPトランスポート（Bearer認証、/health エンドポイント）を選択できます。

ツール

airflow (6 + 1 集約ツール)

meta

search-tools — 自然言語によるツール検索。

プロンプト

環境変数

テスト済みスキーマ

• Airflow Stable REST API (2.x)。Airflow 3.xも /api/v1/ Stableエンドポイント経由で同じインターフェースを公開しているため、このサーバーは2.xおよび3.xの両方のデプロイメントで動作します。

コンパニオンサーバー

dbtアーティファクトの解析、実行結果履歴、DQ結果テーブルについては、@us-all/dbt-mcp を併せてインストールしてください。

ビルド

pnpm install
pnpm run build      # tsc → dist/
pnpm test           # vitest
pnpm run smoke      # spawns dist/index.js, calls initialize + tools/list (set env first)

ライセンス

MIT — LICENSE を参照してください。