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: Apache Airflow 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 )