Agent readiness aeo check

何时使用

适用：

• 准备把某个 MCP 服务器 / API / CLI 接入 Agent 工作流，上线前想量化它的"Agent 就绪度"。
• 同一任务有两三个候选工具，需横向对比谁更适合 Agent 调用。
• 在某品类（数据库、鉴权、抓取等）里想直接捞出评分最高的若干选项。
• 构建会"动态选工具"的 Agent，需要一个可机读的就绪度信号做路由依据。
• 想在 CI 里加一道"工具质量门禁"，低于阈值就拦下。

不该用（负边界）：

• 不做工具的功能/安全/性能实测——AEO 是元数据与接口形态评分，不替代真实联调、用例验证或渗透测试。
• 不要把分数当工具"好不好用"的唯一裁决；分高仅代表 Agent 友好度高。
• 缺少待评工具的 URL/名称、或无法接入 Clarvia MCP 时，先补齐再用。

步骤

1. 接入 Clarvia MCP 服务器（见「指令」）。
2. 选动作：
   • 单工具打分：给 URL 或名称，让其返回 0-100 AEO 分 + 四维拆解。
   • 品类检索：按品类拉排名榜，发现你没考虑过的替代品。
   • 头对头对比：两个工具并排出分 + 推荐结论。
   • 看排行榜：取某能力的 Top N。
3. 读分档（见「示例」表）决定是否采用；分偏低时用 get_score_breakdown 看是哪一维拖后腿，再判断该维度对你的场景是否要紧。
4. （可选）把评分接进 CI 作质量门禁。

四个 AEO 维度：API 可达性、数据结构化、Agent 兼容性、信任信号。

指令

接入 Clarvia MCP 服务器（写入助手的 MCP 配置）：

{
  "mcpServers": {
    "clarvia": {
      "command": "npx",
      "args": ["-y", "clarvia-mcp-server"]
    }
  }
}

调用方式（自然语言驱动对应工具）：

# 单工具打分（aeo_score）
Score https://github.com/example/my-mcp-server for agent-readiness
# 品类检索排名
Find the top-rated database MCP servers using Clarvia
# 头对头对比
Compare supabase-mcp vs firebase-mcp using Clarvia
# 取排行榜 Top N
Show me the top 10 MCP servers for authentication using Clarvia
# 看弱项维度
get_score_breakdown <工具>

CI 质量门禁（GitHub Action，低于阈值则失败）：

- uses: clarvia-project/clarvia-action@v1
  with:
    url: https://your-api.com
    fail-under: 70

示例

装前先评：

Before I add this MCP server to my config, score it:
https://github.com/example/new-tool
用 clarvia 的 aeo_score 打分，并告诉我它是否 agent-ready。

品类选优：

我需要一个网页抓取的 MCP 服务器。用 Clarvia 找评分最高的几个，并对比前三名。

AEO 分档解读：

分数	评级	含义
90-100	Agent Native	专为 Agent 使用而建
70-89	Agent Friendly	好用，仅有小缺口
50-69	Agent Compatible	能用，但需改进
30-49	Agent Partial	有明显限制
0-29	Not Agent Ready	不建议用于 Agent 工作流

注意事项

• 别给"知名工具"开绿灯——热门工具同样可能评分很差，照评不误。
• 生产级 Agent 流水线里，分数低于 50 的工具不要直接用，除非已弄清其限制。
• 长跑型工作流里采用前先评分；工具会迭代，分数要定期复查。
• 工具返回"not found"时，直接用 aeo_score 按 URL 现场打分（Clarvia 会按需评估）。
• 信任你的某工具却评分偏低时，用 get_score_breakdown 看弱在哪一维，再判断是否影响你的场景。
• 源中"15,400+ 已索引工具"等数字为 Clarvia 自报，引用前如有疑虑请以实测为准；本评分不替代环境内验证、测试与专家复核。

互见

• requires：无硬前置；具备 MCP 接入与工具选型基本概念即可。
• related：mcp-builder / agent-tool-builder（按 AEO 高分标准去建/改一个工具）、agent-architecture-audit（更深的 Agent 全栈诊断，AEO 偏选型前轻量筛查）。
• combines_with：agent-workflow-pattern-designer / multi-agent-system-designer（选型结论落回工作流设计）、production-llm-app-builder（上线前把质量门禁接进 CI）。

---

采编自 sickn33/antigravity-awesome-skills（MIT），原条目 clarvia-aeo-check（author digitamaz）。