convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
antonio-mello-ai

MCP Airflow

antonio-mello-ai/mcp-airflow

Controle Apache Airflow direto do Claude via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe operações da REST API do Apache Airflow como ferramentas para Claude. Permite listar DAGs, disparar execuções, monitorar status de tasks e verificar saúde do scheduler, com suporte automático para autenticação em Airflow 2.x e 3.x.

Instalação

$npx convez-ai antonio-mello-ai/mcp-airflow

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 semana
Versão
v0.1.2
Issues abertas
8
Contribuidores
1

Casos de uso

  • Monitorar status de pipelines de dados em tempo real
  • Disparar execuções de DAGs manualmente via conversação
  • Verificar falhas e problemas de scheduler sem sair do Claude
  • Gerenciar orquestração de workflows de forma interativa

Veredito

Integração bem estruturada para quem opera Airflow. Cobre os principais casos de uso de monitoramento e controle, com suporte limpo para ambas versões do Airflow. Útil para times de dados e engenheiros DevOps que precisam gerenciar pipelines via Claude.

README

A tradução para o português deste README ainda está na fila.

mcp-airflow

MCP server that exposes Apache Airflow REST API operations as tools. Built with FastMCP.

Install

# Run directly with uvx (no install needed)
uvx mcp-airflow

# Or install with pip
pip install mcp-airflow

For development:

uv pip install -e ".[dev]"
# or with dependency groups
uv sync --group dev

Configuration

Set these environment variables (or create a .env file from .env.example):

VariableDescriptionExample
AIRFLOW_BASE_URLAirflow REST API base URL. Use /api/v2 for Airflow 3.x or /api/v1 for 2.xhttp://100.x.x.x:8080/api/v2
AIRFLOW_USERNAMEAuth username (JWT on 3.x, basic auth on 2.x)admin
AIRFLOW_PASSWORDAuth password

Authentication

The client picks the auth scheme automatically based on your Airflow version:

  • Airflow 3.x (JWT) — a JWT token is obtained from the /auth/token endpoint using AIRFLOW_USERNAME/AIRFLOW_PASSWORD, sent as a Bearer token, and refreshed automatically. Point AIRFLOW_BASE_URL at /api/v2.
  • Airflow 2.x (basic auth) — if the JWT flow is unavailable, the client falls back to HTTP basic auth with the same username/password. Point AIRFLOW_BASE_URL at /api/v1.

Usage

Run the server:

mcp-airflow

Or add to your MCP client config (e.g., Claude Desktop):

{
  "mcpServers": {
    "airflow": {
      "command": "mcp-airflow",
      "env": {
        "AIRFLOW_BASE_URL": "http://100.x.x.x:8080/api/v2",
        "AIRFLOW_USERNAME": "admin",
        "AIRFLOW_PASSWORD": "your-password"
      }
    }
  }
}

Tools

ToolDescription
list_dagsList all DAGs with paused/active status
get_dag_runs_todayGet all DAG runs from today with status
get_dag_run_statusGet the latest run status for a specific DAG
trigger_dag_runTrigger a manual DAG run
get_task_instancesGet task instances for a specific DAG run
check_failed_dagsCheck for failed DAGs in the last 24 hours
check_scheduler_healthCheck scheduler heartbeat and metadatabase status

Tests

pytest

License

MIT

Ver o original no GitHub

Bom para

Relacionados