@us-all/airflow-mcp

Airflow MCP 서버 — DAG, 실행, 태스크 인스턴스, 로그 테일 읽기; 트리거 및 초기화(쓰기 제한). @us-all/mcp-toolkit 기반으로 구축되었습니다.

Airflow Stable REST API를 위한 집중형 MCP입니다. 기본적으로 읽기 전용이며, airflow-trigger-dag 및 airflow-clear-task는 AIRFLOW_ALLOW_WRITE=true로 설정해야 사용할 수 있습니다.

더 깊은 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를 참조하세요.