acuvity/mcp-server-apache-airflow

mcp-server-apache-airflow镜像说明

镜像概述

本镜像为连接Apache Airflow的MCP服务器，使用官方客户端实现集成，由Acuvity打包并发布至其MCP服务器 registry。镜像基于安全设计理念，提供隔离运行环境、运行时防护及灵活的集成方式，适用于各类需要与Apache Airflow交互的场景。

核心功能

🔐 隔离沙箱特性

• 隔离执行：工具在容器化沙箱内运行，防止横向移动
• 默认非root用户：遵循最小权限原则，降低安全漏洞影响
• 只读文件系统：确保运行时不可变性，阻止未授权修改
• 版本固定：锁定工具及依赖版本，保证部署一致性
• CVE扫描：通过Docker Scout持续扫描已知漏洞
• SBOM与溯源：嵌入元数据及可追溯的构建信息，提升供应链透明度

🛡️ 运行时安全防护

通过Minibridge集成提供多种防护机制（默认关闭，可按需启用）：

• 隐蔽指令检测：识别请求中的隐藏/混淆指令
• 敏感模式检测：拦截敏感数据（如.env文件、RSA密钥路径）
• 影子模式检测：防止***服务器通过工具描述覆盖其他可信工具行为
• ** schema误用防护**：强制遵守MCP输入schema规范
• 跨域工具访问控制：限制对外部服务的调用
• ** secrets脱敏**：自动屏蔽日志/响应中的敏感值（如API密钥、令牌）

🔒 基础认证

通过共享密钥实现轻量级认证：设置BASIC_AUTH_SECRET环境变量即可启用，适用于开发或内部部署场景（建议结合TLS使用）。

使用场景

• IDE集成：支持VS Code、Windsurf、Cursor、Claude Desktop等IDE的MCP配置
• 本地运行：通过Docker直接启动，用于开发测试
• 远程部署：通过Websocket隧道+MTLS实现安全远程访问
• Kubernetes部署：使用Helm Chart快速部署至K8s集群

配置说明

环境变量要求

• AIRFLOW_HOST：必填，Apache Airflow服务地址
• AIRFLOW_USERNAME：必填，Airflow用户名
• AIRFLOW_PASSWORD：必填，Airflow密码
• GUARDRAILS：可选，启用的防护机制（如"secrets-redaction sensitive-pattern-detection"）
• BASIC_AUTH_SECRET：可选，启用基础认证的共享密钥

部署示例

Docker本地运行（HTTP/sse模式）

bash
docker run -it -p 8000:8000 --rm --read-only \
  -e AIRFLOW_HOST="your-airflow-host" \
  -e AIRFLOW_USERNAME="your-username" \
  -e AIRFLOW_PASSWORD="your-password" \
  docker.io/acuvity/mcp-server-apache-airflow:0.2.2

Helm Chart部署（Kubernetes）

bash
helm install mcp-server-apache-airflow oci://docker.io/acuvity/mcp-server-apache-airflow --version 1.0.0 \
  --set env.AIRFLOW_HOST="your-airflow-host" \
  --set secrets.AIRFLOW_USERNAME.value="your-username" \
  --set secrets.AIRFLOW_PASSWORD.value="your-password"

IDE集成示例（VS Code全局配置）

在用户设置JSON中添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-apache-airflow": {
        "env": {
          "AIRFLOW_HOST": "TO_BE_SET",
          "AIRFLOW_PASSWORD": "TO_BE_SET",
          "AIRFLOW_USERNAME": "TO_BE_SET"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "-e",
          "AIRFLOW_HOST",
          "-e",
          "AIRFLOW_PASSWORD",
          "-e",
          "AIRFLOW_USERNAME",
          "docker.io/acuvity/mcp-server-apache-airflow:0.2.2"
        ]
      }
    }
  }
}

支持与反馈

• 维护方：Acuvity团队（打包）、Gyeongmo Yang（原应用）
• 帮助渠道：Acuvity MCP Forge仓库、***社区、GitHub issue tracker
• 架构支持：amd64、arm64
• 基础镜像：ghcr.io/astral-sh/uv:python3.12-alpine