Airflow控制服务器

一个通过Airflow API控制Airflow的Model Context Protocol服务器,支持安全模式和普通模式操作。

  • by salukadev
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 salukadev/airflow-mcp-server-mwaa

使用说明

airflow mcp服务器:用于控制气流的mcp服务器

在Glama上查找

概述

A. 模型上下文协议 用于通过气流API控制气流的服务器。

演示视频

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

设置

使用Claude Desktop

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

注:

  • 集 base_url 到根气流URL(例如。, http://localhost:8080).
  • 做 不 包含 /api/v2 在基本URL中。服务器将自动从以下位置获取OpenAPI规范 ${base_url}/openapi.json.
  • 身份验证只需要JWT令牌。Airflow 3.0不再支持Cookie和基本身份验证。

操作模式

服务器支持两种操作模式:

  • 安全模式 (--safe):只允许只读操作(GET请求)。当您想阻止对Airflow实例进行任何修改时,这很有用。
  • 不安全模式 (--unsafe):允许所有操作,包括修改。这是默认模式。

要在安全模式下启动:

airflow-mcp-server --safe

要在不安全模式下明确启动(尽管这是默认设置):

airflow-mcp-server --unsafe

注意事项

认证

  • Airflow 3.0仅支持JWT身份验证。您必须提供有效的 AUTH_TOKEN.

页数限制

默认值为100个项目,但您可以使用以下命令进行更改 maximum_page_limit 中[api]部分的选项 airflow.cfg 文件。

任务

  • [x] 气流3准备就绪
  • [x] 解析OpenAPI规范
  • [x] 安全/不安全模式实施
  • [x] 使用list_tools解析正确的描述。
  • [x] 获取气流配置(专门用于页面限制)
  • []环境变量可选(env变量可能不适合用于气流插件)