MCP Registry 聚合器
先保证同步可恢复,再增加评分与扫描
接口返回合法 JSON,不代表目录已经完整、及时。正文提供分页、按更新时间筛选和可变状态;消费端要解决的是:抓到一半失败后,怎样继续而不漏数据。以下是基于这些接口的实现建议,不是上游对事务一致性或服务可用性的承诺。
| 同步环节 | 建议处理 | 避免的问题 |
|---|---|---|
| 首次导入 | 跟随全部返回游标,逐批持久化 | 把第一页误当完整目录 |
| 增量抓取 | 一轮分页保持相同筛选边界 | 只抓部分数据就推进时间 |
| 重试 | 按服务器名和版本做幂等 upsert | 重放后出现重复条目 |
| 完成提交 | 全部写入持久化后再推进水位 | 中途崩溃后永久跳过记录 |
| 状态刷新 | 更新已知条目并执行本地可见性策略 | 长期推荐已删除或弃用项 |
游标应作为不透明值处理,用 URL 构造器编码查询参数。访问版本端点时,服务器名称要作为一个路径参数整体编码,名称里的斜杠不能被误解为额外路由层级。上次完整同步成功时间与本轮尝试开始时间应分别记录。
如果不能确认时间边界的精确语义,可采用小幅重叠抓取与幂等写入的消费策略;本页没有承诺事务快照或恰好一次交付。中断后从已持久化的检查点恢复,再通过周期性核对发现本地差异。保留本地数据,也有助于上游不可用时继续提供已抓取目录。
评分和安全扫描应放在自己控制的 _meta 命名空间,保留来源与扫描时间,不把消费端判断伪装成上游发布者的声明。实现 latest 选择前对照版本管理,并区分目录条目与额外评估。本导读提出可恢复同步方案,未声称本站已经部署并运行该聚合器。
聚合器是 MCP Registry 的下游消费者,可在其数据基础上提供附加价值。例如,提供用户评分和安全扫描的服务器市场。
MCP Registry 提供未经身份验证的只读 REST API,聚合器可以用它填充自己的数据存储。聚合器应当定期但不频繁地抓取数据(例如每小时一次),并将数据持久化到自己的数据存储中。MCP Registry 不对正常运行时间或数据持久性作出保证。
使用 MCP Registry REST API
MCP Registry REST API 的基础 URL 是 https://registry.modelcontextprotocol.io。它支持以下端点:
GET /v0.1/servers:列出所有服务器。GET /v0.1/servers/{serverName}/versions:列出一个服务器的所有版本。GET /v0.1/servers/{serverName}/versions/{version}:获取服务器的特定版本。使用特殊版本latest可获取服务器的最新版本。
serverName 和 version 等 URL 路径参数必须进行 URL 编码。例如,io.modelcontextprotocol/everything 必须编码为 io.modelcontextprotocol%2Feverything。聚合器最常抓取的端点可能是 GET /v0.1/servers。
分页
GET /v0.1/servers 端点支持基于游标的分页。
例如,可以使用 limit 查询参数获取第一页:
curl "https://registry.modelcontextprotocol.io/v0.1/servers?limit=100"{
"servers": [
/* ... */
],
"metadata": {
"count": 100,
"nextCursor": "com.example/my-server:1.0.0",
},
}然后,将 nextCursor 的值作为 cursor 查询参数传入,即可获取后续页面:
curl "https://registry.modelcontextprotocol.io/v0.1/servers?limit=100&cursor=com.example/my-server:1.0.0"按更新时间筛选
GET /v0.1/servers 端点支持筛选自给定时间戳以来更新过的服务器。
例如,要获取自 2025-10-23 以来更新过的服务器,可以使用采用 RFC 3339 日期时间格式的 updated_since 查询参数:
curl "https://registry.modelcontextprotocol.io/v0.1/servers?updated_since=2025-10-23T00:00:00.000Z"服务器状态
服务器元数据通常不可变,但 status 字段除外;该字段可能更新为例如 "deprecated" 或 "deleted"。我们建议聚合器及时更新其保存的每个服务器的 status 副本。
"deleted" 状态通常表示服务器违反了我们较为宽松的审核政策,说明该服务器可能是垃圾内容、恶意软件或违法内容。聚合器可以选择将这些服务器从其索引中移除。
充当子注册表
子注册表是一种同时实现 MCP Registry 所定义的 OpenAPI 规范的聚合器。这样,MCP 宿主应用等客户端就能通过标准化接口使用服务器元数据。
子注册表 OpenAPI 规范允许子注册表通过 _meta 字段注入自定义元数据。例如,子注册表可以注入用户评分、下载次数和安全扫描结果:
{
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"name": "io.github.username/email-integration-mcp",
"title": "Email Integration",
"description": "Send emails and manage email accounts",
"version": "1.0.0",
"packages": [
{
"registryType": "npm",
"identifier": "@username/email-integration-mcp",
"version": "1.0.0",
"transport": {
"type": "stdio"
}
}
],
"_meta": {
"com.example.subregistry/custom": {
"user_rating": 4.5,
"download_count": 12345,
"security_scan": {
"last_scanned": "2025-10-23T12:00:00Z",
"vulnerabilities_found": 0
}
}
}
}我们建议将自定义元数据放在能够体现子注册表身份的键下(例如上例中的 "com.example.subregistry/custom")。