managing-astro-local-env – Astro 本地开发环境管理 Skill

3周前更新 8 0 0 0

managing-astro-local-env 是用于管理 Astronomer 软件本地 Airflow 开发环境的 Skill，帮助 AI Agent 在本地启动、配置和调试 Astro 项目并运行 Airflow 工作流。

查看调研报告 在来源平台打开

Skill 安装

多 Agent 安装 
npx skills add https://github.com/astronomer/agents --skill managing-astro-local-env

使用 npx skills 快速安装，支持将 Skill 添加到多个兼容的 AI Agent。

Skill 调研报告

Skill 详细介绍

astronomer/agents#managing-astro-local-env 是 Astronomer 官方 agents 仓库中提供的一个 Skill，用于帮助 AI Agent 在本地环境管理和操作 Apache Airflow 的本地开发环境。它属于 Airflow 生态里的“本地环境管理”类 Skill，而不是一个独立运行的软件、CLI 工具或 Airflow 插件。

它不是什么：它不是 Airflow 本体，不是 Astro CLI 的替代品，也不是云端 Astro 部署工具。它本身不会启动一个新的 Airflow 实例，也不会替用户托管基础设施。

核心用途大致围绕这几件事：

  • 引导 Agent 检查本地 Airflow / Astro 开发环境的当前状态
  • 帮助启动、停止、重启本地 Airflow 环境
  • 协助排查本地环境启动失败、容器异常、依赖缺失等问题
  • 根据项目配置调整本地运行所需的信息
  • 指导用户在本地运行 DAG、测试任务、查看日志

安装后，Agent 增加的能力主要是：在对话中能理解“本地 Airflow 环境”“Astro 本地开发”“DAG 本地调试”这类任务，并按照 Skill 中定义的流程给出命令、检查步骤和排错思路。它不是自动后台服务，所有操作仍由用户或用户在 Agent 中确认后执行。

适合的用户：

  • 使用 Apache Airflow 做数据管道开发的工程师
  • 使用 Astronomer / Astro 工具链，希望在本地跑 Airflow 的开发者
  • 需要在 Claude Code 等 Agent 中辅助排查本地 Airflow 环境问题的用户

不适合的需求：

  • 只想在云端或生产集群上管理 Airflow
  • 不使用 Airflow / Astronomer 工具链
  • 希望 Skill 直接替你完成所有运维决策，不做人工确认

本质上，它更接近一份“本地 Airflow 环境管理的操作指南 + 流程编排”，由 Agent 依据它来组织具体动作，而不是一段可以直接运行的独立程序。

Skill 安全评估

总体判断：来自 Astronomer 官方仓库，来源可信度较高。风险主要不在于 Skill 本身，而在于它涉及的本地环境操作——启动容器、执行 CLI、读写项目文件。这些操作如果交给 Agent 自动执行，会带来与手动执行同等的本地权限风险。

需要关注的安全点：

  • 来源可信度：Skill 出自 Astronomer 官方 agents 仓库，比第三方转载版本更可信。使用时应确认来源是该仓库本身，而不是 Fork 或镜像。
  • Shell 权限：本地 Airflow 环境管理通常涉及执行 Astro CLI、Docker 命令、Airflow CLI 等。若 Agent 被授予自动执行 Shell 的权限，这些命令会在本机真实执行。
  • 文件读写：可能涉及读取项目配置、DAG 文件、环境变量文件，以及对本地开发目录的改动。
  • Docker：启动本地 Airflow 通常依赖 Docker，容器会占用本机端口、挂载项目目录。
  • 网络访问：拉取镜像、安装依赖时需要网络。
  • 凭证：本地 Airflow 环境可能读取连接信息、Airflow 变量、密钥文件。这些内容一旦被 Agent 读取并出现在对话中，存在泄露风险。

降低风险的建议：

  1. 如果只是想让 Skill 帮你生成命令或排错思路，可以关闭 Agent 的自动执行 Shell 权限，由你自己手动复制命令执行。
  2. 不要让 Agent 读取包含真实生产凭证的 .env、连接串、密钥文件。
  3. 在本地或隔离环境中使用，避免直接对生产 Airflow 环境执行操作。
  4. 确认安装的 Skill 来自官方仓库，而不是修改过的副本。
  5. 观察 Agent 给出的每一条命令，再决定是否执行。

没有证据表明该 Skill 本身包含恶意行为，但由于它天然涉及本地命令执行和 Docker 操作，用户仍需按“本机高权限工具”的态度对待。

Skill 使用要求

一、Agent / 客户端

该 Skill 来自 Astronomer 官方的 agents 仓库，面向支持 Skills 机制的 AI Agent。官方没有公布完整的第三方 Agent 兼容列表。

  • Claude Code：与 Skill 机制高度适配，优先推荐在 Claude Code 中使用。
  • Codex、Cursor、Trae、OpenClaw、WorkBuddy：官方未明确声明支持。从 Agent Skill 的一般工作方式看，在支持自定义 Skill 或类似指令加载机制的环境中通常可以尝试使用，具体兼容程度以对应 Agent 当前版本为准。

二、运行环境 / 依赖

项目 要求
Agent 优先 Claude Code，其他兼容 Agent 可尝试
Airflow 开发环境 本地需要 Apache Airflow 相关环境
Astro CLI 若走 Astro 工具链，通常需要（以官方说明为准）
Docker 本地 Airflow 环境一般依赖 Docker
网络 拉取镜像、安装依赖时需要

官方未在本 Skill 中硬性规定 Node.js、Python 的具体版本。实际版本要求取决于你的 Airflow 项目本身和 Astro 工具链要求，以对应官方文档为准。

三、权限

  • Shell 执行：通常需要（用于 CLI、Docker 操作）。可选——可关闭自动执行，改为手动。
  • 文件读取：可能涉及项目配置、DAG 文件、环境变量文件。
  • 文件写入：可能涉及修改本地开发环境相关文件。
  • Docker：启动本地 Airflow 时通常涉及。
  • 网络：拉取镜像、安装依赖时涉及。

四、账号 / API Key

Skill 本身不需要账号或 API Key。它操作的是你本地的 Airflow 开发环境。是否需要在后续操作中提供凭证，取决于你的 Airflow 项目配置——例如连接信息、Airflow 变量、密钥文件等。这些属于你项目自身的需要，不是 Skill 的硬性要求。

最小使用条件

  1. 一个支持 Skill 的 AI Agent（推荐 Claude Code）。
  2. 本地已有或可搭建的 Airflow 开发环境。
  3. Docker 可用。
  4. 网络可用（用于拉取镜像和依赖）。

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令，粘贴到对应 Agent 或终端执行。

如果不知道自己的 Agent 如何安装，可以直接询问当前 Agent：

如何安装 astronomer/agents#managing-astro-local-env？

如何在 Claude Code 中安装 astronomer/agents#managing-astro-local-env？

如何在 Cursor 中安装 astronomer/agents#managing-astro-local-env？

让 Agent 根据自己的 Skill 加载与管理机制来指导安装即可。如果官方对该 Skill 有特殊安装条件，以官方仓库说明为准。

二、安装后如何使用

安装后，在对话中描述与本地 Airflow 环境相关的任务即可触发。适合交给它的任务包括：本地环境启动、停止、排错、DAG 本地运行、日志查看等。

使用示例：

使用 managing-astro-local-env，帮我检查本地 Airflow 环境当前的状态。

使用 managing-astro-local-env，我本地 Airflow 启动失败了，帮我一步步排查。

使用 managing-astro-local-env，指导我在本地运行一个 DAG 并查看日志。

向 Agent 描述需求时，尽量说明：你用的是 Astro 还是原生 Airflow、报错信息是什么、已经尝试过哪些步骤。信息越具体，给出的排错路径越准。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式可能不同。常见做法：

  • 使用对应 Agent / Skill 管理器提供的删除方式移除该 Skill。
  • 直接询问当前 Agent：“如何卸载 astronomer/agents#managing-astro-local-env？”

如果没有统一卸载命令，直接让当前 Agent 按它的 Skill 管理机制移除通常更稳妥。卸载 Skill 不会自动清理你本地已有的 Airflow 环境或容器。

常见问题

1. 安装后 Agent 没有识别到这个 Skill 怎么办？

先确认安装是否完成、安装位置是否是该 Agent 读取 Skill 的目录。不同 Agent 的加载时机不同，部分 Agent 需要重启会话或重新加载。可以直接问当前 Agent 是否能看到这个 Skill。

2. 这个 Skill 会替我改动本地项目文件吗？

取决于 Agent 的权限设置和具体任务。它本身以指导流程为主，真正改动文件的是执行动作。如果不想让 Agent 自动写入，可以关闭自动执行和自动写入权限，由你手动完成。

3. 不使用 Docker 可以用吗？

本地 Airflow 环境通常依赖 Docker 运行。如果你的环境是其他方式搭建的，Skill 的指导路径可能与实际不符，需要结合自己的环境判断。

4. 中国大陆使用是否有网络要求？

拉取 Docker 镜像、安装依赖时可能需要访问境外资源。若你的环境使用国内镜像源或代理，实际体验会不同。Skill 本身不限制地区。

5. 可以同时安装到多个 Agent 吗？

通常可以。但每个 Agent 的 Skill 目录和管理方式独立，需要在各自环境中分别安装和确认。

6. Skill 更新后需要重新安装吗？

取决于你的 Agent 如何管理 Skill。如果是从仓库同步的，拉取最新版即可；如果是手动复制的，需要重新复制。具体以对应 Agent 的 Skill 管理方式为准。

7. 是否适合直接用于生产环境？

该 Skill 面向本地开发环境管理，不建议直接用于生产 Airflow 集群操作。生产环境请使用官方运维流程和权限控制。

Skill 更新日志

版本列表
astro-airflow-mcp-0.9.1 最新
补丁版本：修复了在 FastMCP 3.4.3+ 下插件 `/mcp/v1/` 端点上的 `421 Misdirected Request` 问题，并将 `fastmcp` 固定在有界范围内。 ## 自 0.9.0 以来的修复内容 ### 修复来自 FastMCP 主机防护的 `421 Misdirected Request`（#241） FastMCP 3.4.3 默认启用了 `HostOriginGuardMiddleware`：它只接受回环 `Host` 头（`127.0.0.1`/`localhost`/`::1`）以及 ASGI `scope["server"]` 主机，对其他任何内容返回 `421 Misdirected Request`。在插件模式下，MCP 应用嵌入在 Airflow webserver 中，并通过 Deployment 自身的主机名访问，因此在未固定版本、解析到 fastmcp 3.4.3 的安装中，对 `/mcp/v1/` 的每个请求都被以 421 拒绝。 - 插件现在保持防护**启用**，但将 `allowed_hosts` 限定为 Deployment 的主机名，该主机名从 `AIRFLOW__WEBSERVER__BASE_URL` 环境变量读取（在插件导入时即存在，不同于 Airflow 的 `conf`）。DNS 重绑定防护保持开启，而不是被关闭。 - `ASTRO_MCP_ALLOWED_HOSTS`（逗号分隔）可为自定义域名覆盖允许列表；仅当无法推导出主机名时（非 Astro 嵌入场景），插件才回退为禁用防护。 - 独立模式（`mcp.run`）不变——它保持 FastMCP 的默认回环防护，这正是本地绑定服务器所需的。 - 固定 `fastmcp>=3.4.3,<4`，使行为确定，不会在 FastMCP 下一次默认值翻转时悄然改变。 ## 安装 ``` uvx --from 'astro-airflow-mcp==0.9.1' af ``` ## 升级说明 如果你曾将 `fastmcp<3.4.3` 固定为临时变通方案，升级到 0.9.1 后可以移除该固定。
astro-airflow-mcp-0.9.0
次要版本：现在每个 MCP 工具都返回结构化的、可供 agent 操作的错误，并带有 MCP 安全注解，此外 `af runs list` 新增了结束日期过滤器。 ## 自 0.8.2 以来的新内容 ### 结构化工具错误 + MCP 安全注解（#221） 此前工具将每次失败都折叠为裸的 `str(e)`——agent 无法区分错误的 `dag_id`（修正参数并重试）与 Airflow 不可达（停止并上报），因为两者都返回相同的不透明字符串。 - **错误即数据。** 现在每个工具都返回 `error`、`error_type`、`hint`、`retryable` 标志，以及回显的标识参数（例如 `dag_id`）。`retryable` 将调用方可修复的问题（错误参数、400/404/429）与硬性阻塞（认证、5xx、只读、不可达）区分开，使 agent 知道修正后重试是否有帮助。对 `ReadOnlyError`、`NotFoundError`、Astro 认证错误、`httpx` 状态码、超时和传输错误进行分类。 - **所有 34 个工具上的安全注解。** 27 个读取操作标记为只读 + 幂等；7 个写入操作带有准确的提示——`delete_dag_run` 破坏性 + 非幂等，`clear_*` 破坏性 + 幂等，`pause`/`unpause` 幂等，`trigger*` 非幂等。客户端可以在调用*之前*对写入进行门控，补充现有的 `AF_READ_ONLY` 防护（后者仅在模型决定调用*之后*才拒绝）。默认谨慎：只有当工具明确选择加入时，才会被宣告为“安全”。 - **凭据卫生。** `normalize_airflow_url` 现在会从 netloc 中剥离 `user:password@`（主机/端口/IPv6 原样保留），因此凭据不会泄漏到日志或错误消息中嵌入的 URL 里。 向后兼容——`str(e)` 始终保留在 `error` 内，因此任何 grep 旧裸字符串响应的消费者仍可正常工作；新消费者则可读取结构化字段。 ### `af runs list` 的 `--end-date-gte` / `--end-date-lte` 过滤器（#233） 按运行*结束*时间过滤运行，与现有的 `--start-date-*` 过滤器对应——适用于“过去 N 分钟内完成了哪些运行以及它们如何结束”的恢复排查。ISO 8601 时间戳；`--dag-id` 可选。关闭 #225。 ```bash # 在某个时间窗口内结束的运行，结合状态 af runs list --end-date-gte 2026-06-10T15:00:00Z --state failed ``` ## 安装 ``` uvx --from 'astro-airflow-mcp==0.9.0' af ``` ## 升级说明 可直接替换 0.8.2——仅为新增，无破坏性变更。结构化错误负载是旧字符串的超集（`str(e)` 保留在 `error` 中），因此现有消费者不受影响；新消费者可以读取结构化字段。
astro-airflow-mcp-0.8.2
补丁版本：修复当环境中设置了 `ASTRO_API_TOKEN` 时，`af instance discover` 静默报告“No instances discovered”的问题。 ## 自 0.8.1 以来的修复内容 - **解析 astro CLI 表格输出时跳过前导行**（#213）：当设置了 `ASTRO_API_TOKEN` 时，astro CLI 会在 stdout 前加上 `Using an Astro API Token`。af 表格解析器将该行当作表头行，导致每个 `astro deployment list` 行都被折叠为名为 `using_an_astro_api_token` 的单列，并丢弃每个 deployment——discover 会静默返回零个实例。解析器现在从顶部逐行遍历，并选择第一个边界检测出 2+ 列的行作为真正的表头，因此 astro CLI 输出的任何单行前导都会被自动跳过。 ## 安装 ``` uvx --from 'astro-airflow-mcp==0.8.2' af ``` ## 升级说明 可直接替换 0.8.1。无配置或 CLI 变更。任何在 shell 中设置了 `ASTRO_API_TOKEN` 时遇到 `No instances discovered` 的人，现在都能正确看到 deployments。
astro-airflow-mcp-0.8.1
补丁版本：修复针对 webserver URL 带有 `?orgId=…` 查询字符串的 Astro deployments 的版本检测问题。 ## 自 0.8.0 以来的修复内容 - **从 Airflow URL 中剥离查询字符串 / 片段**（#210）：Astro 发现有时会返回 `webserver_url=https://host/dep?orgId=org_…`。由于 API URL 是通过字符串拼接构建的（`f"{airflow_url}/api/v2/version"`），结果变成 `https://host/dep?orgId=org_…/api/v2/version`，API 路径被吞进查询字符串，破坏了版本检测以及随后的每次 API 调用。新的 `normalize_airflow_url()` 辅助函数会剥离查询、片段和末尾斜杠，应用于四个边界：`discovery/astro_cli.py`（在源头）、`adapters/base.py`（适配器构造函数）、`adapters/airflow_v3.py`（令牌交换）和 `adapters/__init__.py`（`detect_version`）。 - **更好的版本检测错误**：`detect_version` 现在会收集每个探测的失败并在 `RuntimeError` 消息中呈现（`Probes: /api/v2: HTTP 404; /api/v1: HTTP 502; ...`），而不是泛泛的“Failed to detect Airflow version”。还会捕获此前静默漏过的 `200 但非 JSON 正文` 情况。 ## 安装 ``` uvx --from 'astro-airflow-mcp==0.8.1' af ``` ## 升级说明 可直接替换 0.8.0。无配置或 CLI 变更。已将 `?orgId=…` 固化到存储的 `airflow_url` 中的现有用户不再需要重新运行 `af discover`——该值会在读取时被规范化。
astro-airflow-mcp-0.8.0
分层配置版本。`af` 现在跨全局、项目共享和项目本地文件读取和写入配置（对应 `git config` 的 system/global/local 模型），并与 astro-cli 在 `~/.astro/` 共享配置主目录。 ## 自 0.7.0 以来的新内容 - **分层配置**（#207）：三个作用域与 astro-cli 的配置树共置 - 全局：`~/.astro/config.yaml`（每用户） - 项目共享：`/.astro/config.yaml`（已提交；团队共享） - 项目本地：`/.astro/config.local.yaml`（gitignored；每开发者当前实例） - `` 通过从 cwd 向上查找 `.astro/` 找到。项目内的写入路由：`add` / `discover` → 项目共享，`use` → 项目本地。可用 `--global` / `--project` / `--local` 覆盖。`AF_CONFIG=` 完全绕过分层。 - 读取优先级：项目本地 > 项目共享 > 全局。较窄作用域中的同名实例会遮蔽。 - **默认全局路径移动**从 `~/.af/config.yaml` 到 `~/.astro/config.yaml`。旧路径作为一次性只读回退被尊重（并在 stderr 给出弃用提示）。运行 `af migrate` 进行显式迁移并保留 `.bak`。 - **新命令**： - `af migrate`：幂等。报告 `migrated` / `already-migrated` / `nothing-to-migrate`。 - `af instance show `：类似 `git config --show-origin` 的查找，报告实例来自哪个文件。 - **`af instance list`** 现在包含作用域和来源列，并用 `*` 标记当前实例。 - **`save()` 会与外部顶层键合并**（`project`、`cloud`、`contexts`、`telemetry.notice_shown`），使 `af` 和 astro-cli 可以共存于同一文件。往返时保留文件模式；新文件以 0600 写入。 - **Skill**：在 `astro dev init` 时停止固定 Airflow 版本（#206）。修复了模型尽管 CLI 默认使用最新版却传入 `--airflow-version 3.1.0` 的幻觉。 ## 安装 ``` uvx --from 'astro-airflow-mcp==0.8.0' af ``` ## 升级说明 - 现有 `~/.af/config.yaml` 用户：不会出问题。`af` 会将其作为回退读取。方便时运行 `af migrate`。它会合并到 `~/.astro/config.yaml`，保留那里已有的任何 astro-cli 内容，并将旧文件重命名为 `.bak`。 - 在 astro 项目内，`af instance add` 现在默认写入 `.astro/config.yaml`（已提交）。凭据优先使用 `${ENV_VAR}` 插值或 `astro_pat`，或传入 `--local` 用于 gitignored 机密，或 `--global` 用于个人配置。 - `AF_CONFIG=` 和 `AF_CONFIG=/dev/null` 语义不变。
astro-airflow-mcp-0.7.0
PAT 认证重写（#204）的稳定版本，外加 OSError 后续修复（#205） ## 自 0.6.4 以来的新内容 - `af instance discover astro` 现在通过 Auth0 刷新令牌交换复用用户的 `astro login` 会话，而不是铸造永久 `DEPLOYMENT_ADMIN` 令牌。发现的 deployments 使用 `auth.kind = astro_pat`，且从不将令牌写入 af 的配置 - 现有的 `kind = token` 和 `kind = basic` 实例保持不变地继续工作（向后兼容） - 401 重试路径，带一次强制刷新，去抖动为每 60 秒一次 - 轮换的刷新令牌在 flock 下持久化回 `~/.astro/config.yaml`，以免 astro CLI 自身的会话中断 - `astro_context` 在发现时始终固定（避免 `astro context switch` 后的跨租户令牌泄漏） - 朴素的 `expiresin` 字符串锚定到 UTC（纵深防御） - `_read_yaml` 捕获 `FileNotFoundError`、`NotADirectoryError`、`IsADirectoryError`，使非文件的 `ASTRO_HOME` 路径呈现干净的“run astro login”错误，而不是被掩盖的版本检测失败 ## 验证 - 490 个单元测试通过；CI 在所有矩阵条目上全绿（py3.10/11/12，AF2/AF3 集成） - 完整破坏性测试组（约 30 个场景）针对 0.7.0a1 和 0.7.0a2 运行干净 - 使用 otto agent 针对 AF3 云 deployment 和本地 AF2 独立实例进行端到端测试 - 所有测试中未铸造任何 deployment 令牌 ## 安装 ``` uvx --from 'astro-airflow-mcp==0.7.0' af ``` ## 升级说明 - 如果你现有的 af 配置中有由旧 `af instance discover astro` 铸造的 deployment 令牌，它们继续工作。你可以不管它们，或重新运行 discover（如果传入 `--overwrite`，会将其覆盖为 PAT 支持的实例） - 留在你 astro deployments 中的现有 `af-discover-*` 令牌现在是孤儿。方便时在 astro UI 中撤销它们
astro-airflow-mcp-0.7.0a2
后续 alpha 版本，在 0.7.0a1 之上打包了来自 #205 的 OSError 修复 ## 自 0.7.0a1 以来的新内容 - `_read_yaml` 现在捕获表示“无可读 astro 配置”的特定 OSError 形态（`FileNotFoundError`、`NotADirectoryError`、`IsADirectoryError`），而不是泄漏到 `detect_version` 成为被掩盖的“Failed to detect Airflow version”（#205） - `PermissionError` 和其他意外 OS 错误会传播，从而清晰呈现，而不是死路于“run astro login” ## 安装 ``` uvx --from 'astro-airflow-mcp==0.7.0a2' af ```
astro-airflow-mcp-0.7.0a1
PAT 认证重写（PR #204）的 alpha 版本，用于在 otto 中测试后再提升为 0.7.0 稳定版 ## 新内容 - `af instance discover astro` 现在通过 Auth0 刷新令牌交换复用用户的 `astro login` 会话，而不是铸造永久 `DEPLOYMENT_ADMIN` 令牌 - 实例配置中新增 `auth.kind = astro_pat`；现有的 `token` / `basic` 实例保持不变地继续工作 - 401 重试路径，带一次强制刷新，去抖动为每 60 秒一次 - 轮换的刷新令牌在 flock 下持久化回 ~/.astro/config.yaml，以免 astro CLI 自身的会话中断 - 朴素的 `expiresin` 字符串锚定到 UTC（针对手工编辑的纵深防御） ## 安装 ``` uvx --from 'astro-airflow-mcp==0.7.0a1' af ``` ## 为什么是 alpha 发布 alpha 以在提升为 0.7.0 之前，用 otto 的包装器（通过 uvx 固定 af）进行端到端验证
astro-airflow-mcp-0.6.4
## 变更内容 * 在 `runs trigger-wait` 中检测暂停的 DAG，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/190 * af CLI：将空的 AIRFLOW_API_URL 视为显式无操作，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/191 * af CLI：当 AF_CONFIG 指向非普通文件时不再崩溃，作者 @kaxil，见 https://github.com/astronomer/agents/pull/193 * 修复 list_dag_runs（MCP 工具 + af CLI）返回最旧运行在前的问题，作者 @JoaVirtudes19，见 https://github.com/astronomer/agents/pull/192 ## 新贡献者 * @JoaVirtudes19 在 #192 中做出首次贡献 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.6.3...astro-airflow-mcp-0.6.4
astro-airflow-mcp-0.6.3
## 变更内容 * 扩展插件模式文档，加入 Astro 认证、角色和故障排除，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/184 * 为 MCP 服务器添加 Airflow 2.x 插件模式支持，作者 @kaxil，见 https://github.com/astronomer/agents/pull/186 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.6.2...astro-airflow-mcp-0.6.3
astro-airflow-mcp-0.6.2
## 变更内容 * 修复远程 deployments 的 Airflow MCP 插件模式，作者 @kaxil，见 https://github.com/astronomer/agents/pull/183 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.6.1...astro-airflow-mcp-0.6.2
astro-airflow-mcp-0.6.1
## Bug 修复 - 修复当配置文件包含不同实例的凭据时的环境变量认证问题（#181） - 修复：从 TERMINAL_DAG_RUN_STATES 中移除 upstream_failed（#166）
astro-airflow-mcp-0.6.0
## 新内容 ### `af registry` — 查询 Airflow Provider Registry（#145） 四个新的 CLI 命令，可直接从终端浏览 [Airflow Provider Registry](https://airflow.apache.org/registry)——无需运行中的 Airflow 实例： - `af registry providers` — 列出所有 providers（id、name、version、lifecycle） - `af registry modules ` — 列出 operators、hooks、sensors 和 transfers - `af registry parameters ` — 显示 provider 类的构造函数参数 - `af registry connections ` — 显示连接类型及其字段 支持 `--version` 以固定到特定 provider 版本，结果本地缓存（最新版 1 小时，版本化快照 30 天）。使用 `--no-cache` 绕过。 ```bash af registry modules amazon | jq '.modules[] | select(.type == "hook") | .name' af registry parameters ftp | jq '.classes | keys[]' ``` ### 改进 - 为 `list_dag_runs` MCP 工具添加 `dag_id` 过滤器（#163） - 澄清 `get_dag_stats` 要求 `dag_ids` 为列表（#162） ### 修复 - 使发现令牌名称用户特定以避免冲突（#156） - 修复 airflow-adapter skill frontmatter（#147） **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.5.1...astro-airflow-mcp-0.6.0
astro-airflow-mcp-0.5.1
## 变更内容 * 改进 agent 检测，作者 @schnie，见 https://github.com/astronomer/agents/pull/141 * 分离 agent 和 ci_system 属性，作者 @schnie，见 https://github.com/astronomer/agents/pull/142 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.5.0...astro-airflow-mcp-0.5.1
astro-airflow-mcp-0.5.0
## 变更内容 * fix：运行 --plugin-dir 时加载 hooks，作者 @milton-li，见 https://github.com/astronomer/agents/pull/102 * 确保 airflow mcp 包高效使用 uvx 缓存，作者 @schnie，见 https://github.com/astronomer/agents/pull/100 * fix：从 skill 参考文件中移除 doctoc 目录，作者 @kaxil，见 https://github.com/astronomer/agents/pull/107 * 根据早期用户反馈改进 authoring-dags skill，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/104 * 添加 `af` CLI 遥测，作者 @schnie，见 https://github.com/astronomer/agents/pull/106 * 在 skills 中使用 `af` cli，作者 @milton-li，见 https://github.com/astronomer/agents/pull/108 * docs：在 README 中添加缺失的 skills，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/112 * 重构 skill hooks 并扁平化 analyzing-data 脚本，作者 @milton-li，见 https://github.com/astronomer/agents/pull/113 * docs：在 Airflow 2→3 迁移中添加共享工具导入破坏性变更，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/111 * 将 init skill 重命名为 warehouse-init，作者 @kaxil，见 https://github.com/astronomer/agents/pull/114 * 添加 BigQuery 作业标签支持并修复 location 参数 bug，作者 @kaxil，见 https://github.com/astronomer/agents/pull/118 * 添加 Snowflake query_tag 支持，作者 @kaxil，见 https://github.com/astronomer/agents/pull/119 * 添加 Postgres application_name 支持，作者 @kaxil，见 https://github.com/astronomer/agents/pull/120 * 修复 `cosmos-dbt-core/SKILL.md`，作者 @tatiana，见 https://github.com/astronomer/agents/pull/122 * 进一步改进 Cosmos skills，作者 @tatiana，见 https://github.com/astronomer/agents/pull/123 * feat：添加 deployment 管理 agents，作者 @kh3dron，见 https://github.com/astronomer/agents/pull/121 * fix：为自签名证书添加 SSL 证书验证绕过，作者 @kaxil，见 https://github.com/astronomer/agents/pull/126 * 触发前自动取消暂停 DAG，作者 @josh-fell，见 https://github.com/astronomer/agents/pull/127 * docs：澄清 Snowflake 账户标识符格式，作者 @josh-fell，见 https://github.com/astronomer/agents/pull/130 * 移除写入键，作者 @schnie，见 https://github.com/astronomer/agents/pull/128 * feat：添加 `af runs delete` 和 `af runs clear` 命令，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/129 * 迁移到 prek.toml 配置进行静态检查，作者 @josh-fell，见 https://github.com/astronomer/agents/pull/131 * 为 MCP 工具调用添加遥测跟踪，作者 @schnie，见 https://github.com/astronomer/agents/pull/134 * 将遥测配置移入 config.yaml，作者 @schnie，见 https://github.com/astronomer/agents/pull/135 * 从 mypy 迁移到 ty 进行类型检查，作者 @josh-fell，见 https://github.com/astronomer/agents/pull/133 * 处理 Copilot 关于类型安全的反馈，作者 @kaxil，见 https://github.com/astronomer/agents/pull/139 * 实现 AF_READ_ONLY 模式以阻止写操作，作者 @igorastronomer，见 https://github.com/astronomer/agents/pull/138 ## 新贡献者 * @tatiana 在 https://github.com/astronomer/agents/pull/122 中做出首次贡献 * @kh3dron 在 https://github.com/astronomer/agents/pull/121 中做出首次贡献 **完整变更日志**：https://github.com/astronomer/agents/compare/plugin-0.2.0...astro-airflow-mcp-0.5.0
plugin-0.2.0
## Claude 插件版本 自初始发布以来的首次版本号提升，反映累积的变更： ### 新 Skills - Cosmos 集成 - Airflow HITL（Human-in-the-Loop） - 血缘注解 - 最佳实践 - Airflow 2-3 迁移 - 以及更多…… ### 改进 - 用于 skill 建议的 hook 改进 - 用于 Astro deployments 的 `af` CLI 集成 - 多数据库支持（Snowflake、BigQuery 等） ### 安装 ```bash claude plugin marketplace add astronomer/agents claude plugin install data@astronomer ``` 或更新现有安装： ```bash claude plugin marketplace update astronomer/agents ```
astro-airflow-mcp-0.4.1
## 变更内容 * feat(skills)：更新 testing-dags 以使用 af CLI，作者 @kaxil，见 https://github.com/astronomer/agents/pull/75 * refactor(cli)：将 `af api` 标志替换为子命令，作者 @kaxil，见 https://github.com/astronomer/agents/pull/76 * 添加血缘注解和 OpenLineage extractor skills，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/66 * 在根 README 中添加 af CLI 文档，作者 @schnie，见 https://github.com/astronomer/agents/pull/78 * feat(cli)：为 list 命令添加过滤选项，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/79 * docs：添加社区健康文件，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/80 * docs：添加 CODE_OF_CONDUCT.md，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/81 * 在 README 中添加路线图部分，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/74 * 添加 `af instance discover` 命令以自动发现 Astro deployments，作者 @schnie，见 https://github.com/astronomer/agents/pull/63 * Skill：Airflow HITL，作者 @igorastronomer，见 https://github.com/astronomer/agents/pull/95 * Skill：更新 airflow 2-3 迁移 skill，作者 @igorastronomer，见 https://github.com/astronomer/agents/pull/99 * Skill：Cosmos，作者 @igorastronomer，见 https://github.com/astronomer/agents/pull/96 ## 新贡献者 * @igorastronomer 在 https://github.com/astronomer/agents/pull/95 中做出首次贡献 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.4.0...astro-airflow-mcp-0.4.1
astro-airflow-mcp-0.4.0
## 变更内容 * 更好地支持 airflow skill，作者 @schnie，见 https://github.com/astronomer/agents/pull/65 * fix：为 uvx af CLI 使用 @latest 后缀以防止陈旧版本问题，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/68 * fix：配置加载失败时发出警告而不是静默回退，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/70 * feat(cli)：添加 `af api` 命令以直接访问 Airflow REST API，作者 @kaxil，见 https://github.com/astronomer/agents/pull/73 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.3.0...astro-airflow-mcp-0.4.0
astro-airflow-mcp-0.3.0
## 变更内容 * 将 astro-dwh-mcp 切换为从 git 标签动态版本化，作者 @schnie，见 https://github.com/astronomer/agents/pull/46 * 提升 MCP 服务器版本标签，作者 @schnie，见 https://github.com/astronomer/agents/pull/47 * feat：airflow mcp skill 和 hook，作者 @milton-li，见 https://github.com/astronomer/agents/pull/45 * 添加 Cursor hooks 兼容性，作者 @kaxil，见 https://github.com/astronomer/agents/pull/50 * 添加 clear_task_instances MCP 工具以重试失败任务，作者 @petedejoy，见 https://github.com/astronomer/agents/pull/51 * 按领域将 server.py 拆分为模块化工具文件，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/52 * 更新 pre-commit hooks，作者 @jedcunningham，见 https://github.com/astronomer/agents/pull/55 * 修复 skill hook 路径以解析到正确目录，作者 @josh-fell，见 https://github.com/astronomer/agents/pull/56 * 为 analyzing-data skill 添加多数据库支持，作者 @kaxil，见 https://github.com/astronomer/agents/pull/57 * 为 analyzing-data skill 添加多数据库文档，作者 @kaxil，见 https://github.com/astronomer/agents/pull/58 * 将配置路径从 `~/.astro/ai/config/` 重命名为 `~/.astro/agents/`，作者 @kaxil，见 https://github.com/astronomer/agents/pull/59 * 通过 SQLAlchemy 连接器添加 Redshift 支持，作者 @kaxil，见 https://github.com/astronomer/agents/pull/60 * 用统一方言注册表重构 SQLAlchemy 连接器，作者 @kaxil，见 https://github.com/astronomer/agents/pull/61 * 添加 Airflow API Skill，作者 @schnie，见 https://github.com/astronomer/agents/pull/53 * 添加 CLI 命令并修复 CI 构建，作者 @schnie，见 https://github.com/astronomer/agents/pull/62 ## 新贡献者 * @petedejoy 在 https://github.com/astronomer/agents/pull/51 中做出首次贡献 * @jedcunningham 在 https://github.com/astronomer/agents/pull/55 中做出首次贡献 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.2.3...astro-airflow-mcp-0.3.0
astro-airflow-mcp-0.2.3
该版本暂未提供更新说明。

暂无评论

none
暂无评论...