Cert Atlas

cert-atlas-mcp

一个基于 Cert Atlas 构建的 MCP 服务——这是一个开放的认证考试蓝图索引。它让任何 AI 助手（Claude、Cursor 等）都能搜索考试、获取完整的结构化蓝图并比较认证，同时每条结果都附有免费练习链接。

Cert Atlas 发布了机器可读的蓝图，涵盖 223 个认证机构的 1,673 场考试——包括考试领域和主题权重、及格分数、题目数量、时长、先决条件、重考／续期规则、语言、官方来源链接，以及适用时经过审核的备考指导。此服务通过 MCP 向 Agent 提供这些数据集。只读、公开数据，无需 API 密钥。

工具

工具	功能
search_exams	在全部 1,673 份蓝图中按关键词搜索（厂商、考试代码、认证名称、主题）。可选按 certifying_body / vendor_slug 筛选。返回匹配项及其 id、领域数量、题目数量、时长和练习链接。
get_exam_blueprint	获取某场考试的完整蓝图（按 id、代码或名称）：领域及范围、考试安排、先决条件、经过审核的指导、汇总备考信号和来源核验信息。
compare_exams	并排比较 2–8 场考试：题目数量、时长、及格分数、价格、有效期和领域数量。
list_certifying_bodies	列出全部 223 个认证机构及其考试数量（可选使用 contains 筛选）——有助于缩小搜索范围。

资源与提示词

• 资源：cert-atlas://index（主索引）和 cert-atlas://exam/{exam_id}（单份蓝图）——Agent 可以浏览数据，也可以直接附加数据。
• 提示词：study-plan（参数：cert）根据真实蓝图构建按主题权重分配的计划；compare-certs（参数：certs）用于开展结构化比较。

练习链接引流

任何工具返回的每场考试都会附带其 QuizForge 免费练习链接，并带有 UTM 归因参数——?utm_source=mcp&utm_medium=cert_atlas&utm_campaign=<tool>（保留现有查询参数）——因此该服务也兼具可衡量的引流功能。链接内容准确且唯一（每场考试一个）；用户获得的实际价值是免费的真实模拟考试。

安装

npm install
npm run build

与 Claude Desktop / Claude Code 配合使用

添加到 MCP 配置（claude_desktop_config.json，或通过 claude mcp add）：

{
  "mcpServers": {
    "cert-atlas": {
      "command": "node",
      "args": ["/absolute/path/to/cert-atlas/mcp/dist/index.js"]
    }
  }
}

或者，发布到 npm 后即可使用（适用于 Claude Desktop/Code 和 Cursor — .cursor/mcp.json）：

{
  "mcpServers": {
    "cert-atlas": { "command": "npx", "args": ["-y", "cert-atlas-mcp"] }
  }
}

示例提示词

• “AWS Solutions Architect Associate 考试包含哪些领域？各领域的权重是多少？”
• “比较 CompTIA Security+ 和 CySA+——哪个更难、哪个更便宜？”
• “CISSP 的先决条件和及格分数是什么？”
• “Cert Atlas 涵盖哪些护理认证？”

工作原理

该服务读取 Cert Atlas 数据集，并优先使用本地文件而非网络数据：

1. 包中附带 index.json（及 vendors.json）的内置快照 → 即时离线搜索，安装包体积小。
2. 按需从 raw.githubusercontent.com/hans6883/cert-atlas/master 延迟获取单份蓝图并缓存，因此安装包保持小巧，数据也能保持最新。
3. 在 cert-atlas 仓库内运行时，会直接读取规范的 ../data/（始终保持同步）。

每次运行 npm run build 时，都会根据 ../data 重新生成内置快照（参见 scripts/copy-data.mjs）。

“已核验”的含义

当证书的身份已在颁发机构自身网站上核验后，记录会包含一个 credential 区块：包括颁发机构是否为其提供考试、证书类型、颁发机构印制的准确考试代码（如果没有则注明无），以及官方内容大纲。如果颁发机构不为某项证书提供考试（例如仅通过提名授予的级别、会员级别或培训项目），则会如实说明——不会为其显示蓝图、领域权重或练习链接。证书生命周期信息（停考、计划停考、替代关系）也会以相同方式核验并注明日期。

环境变量（均为可选）

变量	默认值	用途
CERT_ATLAS_LOCAL	—	cert-atlas 仓库检出目录的路径；读取其 data/ 目录（用于 VPS/远程部署）。
CERT_ATLAS_DATA_DIR	仓库/捆绑的 data/	指定特定数据目录。
CERT_ATLAS_RAW_BASE	https://raw.githubusercontent.com/hans6883/cert-atlas/master	覆盖远程数据集基址（例如分支或镜像）。

远程 HTTP 构建

同样的四个工具也通过 MCP Streamable HTTP 传输提供服务，无需安装客户端即可托管：

npm run build
npm run start:http        # PORT (default 3000), HOST (default 0.0.0.0)
# POST /mcp   — MCP endpoint
# GET  /health — liveness probe -> {"ok":true}

它是无状态的（每个请求都会启动一个全新的服务），因此无需会话存储即可水平扩展。项目附带 Dockerfile：

docker build -t cert-atlas-mcp .
docker run -p 3000:3000 cert-atlas-mcp

将它部署在反向代理（TLS）后面，并让支持 HTTP 的 MCP 客户端连接到 https://<host>/mcp。

在线端点： https://mcp.quizforge.ai/mcp（健康检查：https://mcp.quizforge.ai/health）——可将其添加为任意支持 HTTP 的 MCP 客户端中的自定义/远程连接器，无需安装。

发布

npm（stdio 包）：

npm login
npm publish --access public      # runs the build via prepublishOnly

官方 MCP 注册表（registry.modelcontextprotocol.io）——使用 server.json；package.json 包含用于所有权验证的匹配 mcpName：

# one-time: install the publisher CLI, then authenticate via GitHub
mcp-publisher login github
mcp-publisher publish            # reads ./server.json

smithery.yaml 可让 Smithery 收录该项目。发布后，其他目录（Glama、PulseMCP、mcp.so）会从 npm 和 GitHub 自动编入索引。

许可证

MIT——详见仓库中的 LICENSE。Cert Atlas 仅索引公开可用的考试结构（不含专有试题）；蓝图内容归相应认证机构所有。