Anomalyarmor

armor-mcp

AnomalyArmor MCP 服务可让 AI 助手（Claude Code、Cursor、Claude Desktop 和任何 MCP 客户端）通过 50 多种结构化工具，以自然语言与您的数据仓库交互：查询告警、监控数据新鲜度、调查架构漂移、配置有效性规则以及追踪数据血缘。

• 主页：https://www.anomalyarmor.ai
• 文档：https://docs.anomalyarmor.ai/integrations/mcp-server
• 服务卡片：https://www.anomalyarmor.ai/.well-known/mcp/server-card.json
• 状态：生产环境。版本化 MCP 协议 2025-06-18。OAuth 2.1 + API 密钥身份验证。

两种连接方式

方式	身份验证	适用场景
远程（推荐）	OAuth 2.1 (Clerk)	无需安装，始终保持最新
本地	API 密钥	隔离网络、值班笔记本、自定义代理

远程（推荐）

服务托管在 https://mcp.anomalyarmor.ai/mcp（Streamable HTTP 传输）。首次调用时会打开浏览器进行 OAuth 身份验证；令牌会缓存约 12 小时。

Claude Code

claude mcp add anomalyarmor --transport http https://mcp.anomalyarmor.ai/mcp

Cursor

添加到 ~/Library/Application Support/Cursor/mcp.json（macOS）、~/.config/Cursor/mcp.json（Linux）或 %APPDATA%\Cursor\mcp.json（Windows）：

{
  "mcpServers": {
    "anomalyarmor": {
      "url": "https://mcp.anomalyarmor.ai/mcp"
    }
  }
}

任何 MCP 客户端

URL: https://mcp.anomalyarmor.ai/mcp
Transport: streamable-http
Auth: OAuth 2.1
Discovery: https://mcp.anomalyarmor.ai/.well-known/oauth-protected-resource

本地（API 密钥）

远程服务不可访问，或您不希望依赖第三方时使用。

安装

# Recommended: uvx (no install)
uvx armor-mcp

# Or pip
pip install armor-mcp

配置

在 https://app.anomalyarmor.ai 的 Settings → API Keys 中获取 API 密钥。

export ARMOR_API_KEY=aa_live_your_key_here

或者将配置持久化到 ~/.armor/config.yaml：

api_key: aa_live_your_key_here

连接到客户端

{
  "mcpServers": {
    "anomalyarmor": {
      "command": "uvx",
      "args": ["armor-mcp"],
      "env": {
        "ARMOR_API_KEY": "aa_live_your_key_here"
      }
    }
  }
}

工具

共有 8 个类别的 53 种工具。每种工具都附带 MCP ToolAnnotations（readOnlyHint、destructiveHint、idempotentHint、openWorldHint: false），以便宿主决定何时自动确认。

健康状况与简报

工具	说明
health_summary	仓库整体健康状况：过期资产、漂移、告警
get_todays_briefing	包含关键洞察的每日摘要
get_coverage	监控覆盖率分析
manage_coverage	更新覆盖率目标
recommend	AI 推荐的后续监控操作

告警与事件

工具	说明
list_alerts	按条件筛选并查询告警（严重程度、日期、状态）
list_inbox_alerts	尚未分类的告警
get_alerts_summary	汇总计数和趋势
get_alert_trends	跨周期趋势分析
get_alert_history	告警活动时间线
update_alert	确认 / 解决 / 忽略 / 暂停告警
list_alert_rules	查看已配置的规则
create_alert_rule	添加新的告警规则
manage_alert_rule	更新 / 删除 / 预览规则
manage_rule_destinations	配置规则的目标位置

资产

工具	说明
list_assets	按条件筛选并列出数据源
create_asset	连接新的数据源
manage_asset	更新 / 删除 / 测试连接
trigger_asset_discovery	启动架构发现（异步）

数据新鲜度

工具	说明
get_freshness_summary	数据新鲜度概览
check_freshness	检查指定资产 / 表
setup_freshness	批量创建数据新鲜度计划
list_freshness_schedules	查看已配置的计划
manage_freshness_schedule	更新 / 删除计划

架构监控

工具	描述
get_schema_summary	架构漂移概览
list_schema_changes	最近的变更及其严重程度
create_schema_baseline	将当前架构保存为基线
enable_schema_monitoring	启动漂移检测
disable_schema_monitoring	停止漂移检测

数据质量（指标与有效性）

工具	描述
get_metrics_summary	按资产查看指标健康状况
list_metrics	列出已配置的指标
create_metric	添加指标（行数、空值百分比等）
manage_metric	更新 / 删除 / 采集指标
get_validity_summary	有效性规则的通过 / 失败率
list_validity_rules	列出有效性规则
create_validity_rule	添加 NOT_NULL / UNIQUE / RANGE / REGEX 规则
manage_validity_rule	更新 / 删除 / 运行规则
create_referential_check	跨表引用检查
manage_referential	更新 / 删除引用检查

目标与路由

工具	描述
list_destinations	Slack / 电子邮件 / webhook / PagerDuty 配置
setup_destination	添加新的目标
manage_destination	更新 / 删除 / 测试

智能分析、数据血缘、标签、作业

工具	描述
ask_question	以自然语言同步问答，了解您的数据
generate_intelligence	触发 AI 分析（异步，开销较大）
get_lineage	上游 / 下游依赖关系图
list_tags	查看资产的标签
create_tag	为表或列添加标签
apply_tags	批量应用标签
job_status	跟踪异步作业
cancel_job	取消正在运行的异步作业
get_api_key_info	检查当前 API 密钥的权限范围

完整说明、参数架构和提示词示例：https://docs.anomalyarmor.ai/integrations/mcp-server。

工具安全约定

宿主会遵循以下注解：

类别	模式	确认方式
只读	list_*、get_*、check_*、search_*	自动调用
修改	create_*、update_*、enable_*、disable_*、manage_*	需向用户确认
破坏性操作	delete_*（通过 manage_*）、dismiss_alert	始终确认；列出受影响的实体
高开销操作	generate_intelligence、trigger_asset_discovery	需确认；这些操作会将付费作业加入队列

多租户

OAuth 令牌（或 API 密钥）的权限范围限定为用户所属公司。您不能冒充其他租户。不要伪造 company_id 参数。

异步作业

trigger_asset_discovery、generate_intelligence 和指标采集会返回 job_id。请使用 job_status(job_id) 轮询状态，而不要重复触发。

发现入口

文件	用途
https://mcp.anomalyarmor.ai/.well-known/oauth-protected-resource	RFC 9728 受保护资源元数据
https://www.anomalyarmor.ai/.well-known/mcp/server-card.json	SEP-1649 MCP 服务卡片
https://www.anomalyarmor.ai/.well-known/agent-card.json	A2A v0.2 Agent 卡片
https://www.anomalyarmor.ai/.well-known/api-catalog	RFC 9727 API 目录链接集

开发

git clone https://github.com/anomalyarmor/agents.git
cd agents/armor-mcp
uv sync
uv run pytest

许可证

MIT — 请参阅 LICENSE。