acuvity/mcp-server-atlan

什么是mcp-server-atlan？

描述：Atlan MCP服务器允许通过多种工具与Atlan服务交互，由Acuvity打包并发布到精选MCP服务器注册表，基于atlan-mcp-server的原始源码。

快速链接：

• https://github.com/acuvity/mcp-servers-registry/blob/main/mcp-server-atlan/docker/README.md#-clients-integrations
• https://github.com/acuvity/mcp-servers-registry/blob/main/mcp-server-atlan/docker/README.md#-run-it-with-docker
• https://github.com/acuvity/mcp-servers-registry/blob/main/mcp-server-atlan/charts/mcp-server-atlan/README.md#how-to-install

核心功能

🔐 关键安全特性

📦 隔离的不可变沙箱

🛡️ 运行时安全与防护

Minibridge集成：Minibridge建立安全的Agent到MCP连接，支持Rego/HTTP-based策略执行，并简化编排。容器内置Rego策略，提供运行时防护，包括资源完整性、隐蔽指令检测、敏感模式检测等（默认仅启用资源完整性，可按需开启其他防护）。

使用场景

🧰 客户端集成

Visual Studio Code

全局范围

按下ctrl + shift + p，输入Preferences: Open User Settings JSON，添加以下配置：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-atlan": {
        "env": {
          "ATLAN_API_KEY": "待设置",
          "ATLAN_BASE_URL": "待设置"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "-e",
          "ATLAN_API_KEY",
          "-e",
          "ATLAN_BASE_URL",
          "docker.io/acuvity/mcp-server-atlan:0.3.1"
        ]
      }
    }
  }
}

工作区范围

在工作区创建.vscode/mcp.json文件，添加以下配置：

json
{
  "servers": {
    "acuvity-mcp-server-atlan": {
      "env": {
        "ATLAN_API_KEY": "待设置",
        "ATLAN_BASE_URL": "待设置"
      },
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "-e",
        "ATLAN_API_KEY",
        "-e",
        "ATLAN_BASE_URL",
        "docker.io/acuvity/mcp-server-atlan:0.3.1"
      ]
    }
  }
}

其他IDE集成

包括Windsurf IDE、Cursor IDE、Claude Desktop及OpenAI Python SDK，具体配置可参考原始文档。

🐳 Docker运行

本地HTTP/sse模式

console
docker run -it -p 8000:8000 --rm --read-only -e ATLAN_API_KEY -e ATLAN_BASE_URL docker.xuanyuan.run/acuvity/mcp-server-atlan:0.3.1

客户端配置示例：

json
{
  "mcpServers": {
    "acuvity-mcp-server-atlan": {
      "url": "http://localhost:8000/sse"
    }
  }
}

☁️ Kubernetes部署

Helm Charts安装

console
helm install mcp-server-atlan oci://docker.io/acuvity/mcp-server-atlan --version 1.0.0

需提前设置必填的ATLAN_API_KEY（作为Secret）和ATLAN_BASE_URL（环境变量）。

配置说明

环境变量

• 必填：ATLAN_API_KEY（Atlan服务的API密钥）、ATLAN_BASE_URL（Atlan服务的基础URL）
• 可选：ATLAN_AGENT_ID（Agent ID，默认未设置）

镜像签名验证

使用Cosign验证镜像签名：

console
cosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-atlan:latest

维护与支持

• 维护者：Acuvity团队（打包）、AtlanHQ（原始源码）
• 支持渠道：Acuvity MCP Forge仓库、***社区、GitHub issue追踪器
• 架构支持：amd64、arm64
• 基础镜像：ghcr.io/astral-sh/uv:python3.12-alpine