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.

Related MCP server: Airthings Consumer MCP Server

Vídeo de demostración

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

Configuración

Uso con Claude Desktop

{ "mcpServers": { "airflow-mcp-server": { "command": "uvx", "args": [ "airflow-mcp-server", "--base-url", "http://localhost:8080", "--auth-token", "<jwt_token>" ] } } }

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:

airflow-mcp-server --safe

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

airflow-mcp-server --unsafe

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 )