airflow-mcp-server

airflow-mcp-server: Airflow를 제어하기 위한 MCP 서버

Glama에서 찾아보세요

개요

Airflow API를 통해 Airflow를 제어하기 위한 모델 컨텍스트 프로토콜 서버입니다.

데모 비디오

https://github.com/user-attachments/assets/f3e60fff-8680-4dd9-b08e-fa7db655a705

설정

Claude Desktop과 함께 사용

지엑스피1

메모:

• base_url 루트 Airflow URL(예: http://localhost:8080 )로 설정합니다.
• 기본 URL에 /api/v2 포함하지 마세요 . 서버가 ${base_url}/openapi.json 에서 OpenAPI 사양을 자동으로 가져옵니다.
• 인증에는 JWT 토큰만 필요합니다. 쿠키와 기본 인증은 Airflow 3.0에서 더 이상 지원되지 않습니다.

작동 모드

서버는 두 가지 작동 모드를 지원합니다.

• 안전 모드 ( --safe ): 읽기 전용 작업(GET 요청)만 허용합니다. Airflow 인스턴스가 수정되는 것을 방지하려는 경우 유용합니다.
• 안전하지 않은 모드 ( --unsafe ): 수정을 포함한 모든 작업을 허용합니다. 기본 모드입니다.

안전 모드에서 시작하려면:

안전하지 않은 모드에서 명시적으로 시작하려면(기본값임):

고려 사항

입증

• Airflow 3.0에서는 JWT 인증만 지원됩니다. 유효한 AUTH_TOKEN 제공해야 합니다.

페이지 제한

기본값은 100개 항목이지만 airflow.cfg 파일의 [api] 섹션에 있는 maximum_page_limit 옵션을 사용하여 변경할 수 있습니다.

작업

• [x] 에어플로우 3 준비
• [x] OpenAPI 사양 구문 분석
• [x] 안전/안전하지 않은 모드 구현
• [x] list_tools를 사용하여 적절한 설명을 구문 분석합니다.
• [x] Airflow 구성 가져오기( 특히 페이지 제한용 )
• [ ] 환경 변수는 선택 사항입니다( 환경 변수는 Airflow 플러그인에 적합하지 않을 수 있음 )