airflow-mcp-server

airflow-mcp-server: Un servidor MCP para controlar Airflow

Encuéntralo en Glama

Descripción general

Un servidor de protocolo de contexto de modelo para controlar Airflow a través de las API de Airflow.

Vídeo de demostración

https://github.com/archivos-adjuntos-de-usuario/activos/f3e60fff-8680-4dd9-b08e-fa7db655a705

Configuración

Uso con Claude Desktop

Nota:

• Establezca base_url en la URL raíz de Airflow (por ejemplo, http://localhost:8080 ).
• No incluya /api/v2 en la URL base. El servidor obtendrá automáticamente la especificación OpenAPI desde ${base_url}/openapi.json .
• Solo se requiere el token JWT para la autenticación. Las cookies y la autenticación básica ya no son compatibles con Airflow 3.0.

Modos de operación

El servidor admite dos modos de funcionamiento:

• Modo seguro ( --safe ): Solo permite operaciones de solo lectura (solicitudes GET). Esto es útil para evitar modificaciones en la instancia de Airflow.
• Modo inseguro ( --unsafe ): Permite todas las operaciones, incluidas las modificaciones. Este es el modo predeterminado.

Para iniciar en modo seguro:

Para iniciar explícitamente en modo inseguro (aunque este es el valor predeterminado):

Consideraciones

Autenticación

• Airflow 3.0 solo admite la autenticación JWT. Debe proporcionar un AUTH_TOKEN válido.

Límite de páginas

El valor predeterminado es 100 elementos, pero puede cambiarlo utilizando la opción maximum_page_limit en la sección [api] del archivo airflow.cfg .

Tareas

• [x] Preparación para Airflow 3
• [x] Analizar la especificación de OpenAPI
• [x] Implementación del modo seguro/inseguro
• [x] Analice la descripción adecuada con list_tools.
• [x] Obtención de configuración de Airflow ( específicamente para el límite de páginas )
• [ ] Variables de entorno opcionales ( las variables de entorno podrían no ser ideales para los complementos de flujo de aire )