HISTOR 为 MCP 注册表补上工具历史
HISTOR 在 MCP 服务声明之外,记录实际观测到的 tools/list,并提供兼容注册表 v0.1 API 的副本。它按计划检查无需凭据的远程服务,并按发布版本检查 npm 与 PyPI 服务包,补充工具清单及其变化信息。
AI 深度解读
当团队把 MCP Registry 用作准入名单,管理员会遇到一个具体问题:发布者登记了服务器地址和版本,但这个地址上次能不能读到工具列表,列表最近变没变?HISTOR 给官方注册表做了一份兼容副本,把自己读到的 tools/list 结果和变化历史附在条目上。
作者实测了这份副本的同步、抽样一致性和公开工具清单的覆盖率。对维护团队白名单的人来说,最实用的是能在审批前查到历史变化,也能看出哪些条目还得用团队自己的账号验证。
同一个注册表条目,怎么同时看到声明和实测记录?
官方 MCP Registry 记录的是发布者提交的信息,包括名称、版本、描述、远程地址或软件包。tools/list 则是 MCP 服务器在一次连接中返回的工具清单。登记了某个端点,只说明发布者声明了它。要知道当时有哪些工具、之后有没有变化,还得实际读取并保留记录。
作者团队从 10 月起定期读取无需凭据的远程端点,并对 npm、PyPI 软件包按发布版本各读取一次,把结果写入带签名的日志。自 2026 年 11 月 21 日起,HISTOR 提供兼容官方 v0.1 API 的副本。GET /v0.1/servers 支持 cursor、limit、search、updated_since 和 version,同时提供 /v0.1/servers/{name}/versions 和 /v0.1/servers/{name}/versions/{version},版本也可以写 latest。
副本原样保留 server 和官方 _meta 数据,再在最新版本的 _meta 下追加 dev.modelmarket.histor/observed。每个远程地址或软件包对应一个 target,里面有状态、工具数量、工具集合摘要 toolSetDigest、注解等附加内容的摘要、首次记录和最近读取的时间,以及可逐版本比较清单的日志页面。
下面两条命令用近期版本的 curl 和 jq 查看同一个 WARDEN 条目的官方元数据键和 HISTOR 的观测字段。
curl -s 'https://registry.modelcontextprotocol.io/v0.1/servers/io.github.alexar76%2Fwarden/versions/latest' \
| jq '._meta | keys'
curl -s 'https://histor.modelmarket.dev/v0.1/servers/io.github.alexar76%2Fwarden/versions/latest' \
| jq '._meta["dev.modelmarket.histor/observed"].targets[] | {endpoint, lastStatus, toolCount, unchangedSince, changes}'
第二条命令中的 targets[] 会逐个展开端点。作者在 11 月 21 日读到的 WARDEN 版本是 0.35.0,其 npm:@aimarket/warden 状态为 ok,有 9 个工具,累计变化 5 次,从 2026-11-18T20:23:31Z 起保持稳定,最近读取时间为 2026-11-20T20:28:37Z。

近七万条记录里,有多少能查到工具清单?
作者在 2026 年 11 月 21 日 17:02 至 17:11 UTC,用 count.py 遍历了 GET /v0.1/servers?version=latest 返回的 69,634 条记录。每个服务器归入首个符合条件的类别,结果保存在 counts-2026-11-21.json。

有工具清单记录的共 41,970 个,占 60.3%。其中 18,368 个自首次记录以来至少变过一次,6,545 个在统计前 7 天内有过变化。还有 6,709 个只能查到较早的记录,因为最近一次读取失败,或站点的 robots.txt 已经禁止抓取。审查时要把 lastStatus 和 lastObserved 一起看,单看 toolCount 容易把历史清单当成当前结果。
其余条目分成五类:9,612 个(13.8%)返回 HTTP 401 或 403,需要凭据或拒绝访问;5,258 个(7.6%)受 robots.txt 限制或无法读取该文件;7,238 个(10.4%)读取失败,原因包括安装失败、进程退出、404、410、协议错误、私有地址和超时;4,376 个(6.3%)因包类型、传输方式或模板化 URL 未尝试;1,180 个(1.7%)还没有观测信息。
GitHub MCP Server 2.2.0 和 Notion MCP 1.0.1 正好说明这个边界。两者的远程端点都返回 http-401。GitHub 的 OCI 容器返回 package-type-not-observed,Notion 的 SSE 端点返回 transport-not-observed。作者用虚构名称 io.example/not-there 演示的 404 则表示副本里没有这个名称,和端点读取失败是两回事。
团队只批准几个服务器,需要同步整个注册表吗?
HISTOR 可以用精确名称或 namespace/* 配置白名单,上游可选官方注册表或另一个兼容副本。以上游 histor.modelmarket.dev 为例,观测数据也会随条目同步。作者演示的白名单匹配了 WARDEN、GitHub MCP Server 和 Notion MCP,同步读取并保存 3 条、耗时约 4 秒。把 HISTOR_CRAWL_INTERVAL_S 和 HISTOR_REMOTE_INTERVAL_S 都设成 0,本地实例就只同步和提供名单。PyPI 上的 aimarket-histor 0.10.0 早于子注册表功能,演示用 Python 3.11 或更新版本,从固定提交 fb35e7a0681a3ec009d61ccf49ed1858ab6dbc63 安装,再运行 .venv/bin/python -m histor.subregistry sync --full。
全量副本首次按 version=latest 遍历,之后每小时按 updated_since 增量同步,查询范围向前重叠 10 分钟,等所有分页写完才推进检查点。条目按名称和版本插入或更新,所以下次同步可以重读中断的范围。每周还会全量对账一次。官方注册表仍在预览,可能重置数据,因此全量返回数低于本地条目数的一半时,HISTOR 会跳过下架标记。
生产实例首次全量同步约 19.5 分钟,从 10:28:06 到 10:47:41 UTC,共读 695 页、69,484 条,保存 69,483 条、跳过 1 条。作者随机抽了 30 条,与官方 versions/latest 比较,server 和官方 _meta 全部一致。后续同步可通过 /api/v1/subregistry 查看。默认是 SQLite 和开发配置,作者给出的生产配置是 PostgreSQL 加 HISTOR_PROFILE=prod,启动时要求 HTTPS 上游、HTTPS 公共基础地址和 operator token。
我的判断
这份副本适合给审批人员提供两类线索:哪些服务器的工具清单变过,哪些端点需要自己连进去看。逐个连接服务器可以验证当前账号实际看到了什么,HISTOR 的价值在于省掉查公开清单和积累历史的重复工作。原文没有给出两种做法的耗时对照,能省多少审批时间仍是经验判断。统计也只覆盖公开定义,工具发生变化和工具实际执行行为都需要另行验证。
GitHub Copilot 的 MCP Registry URL 在原文中仍属公开预览。Allow all 把注册表条目作为推荐,Registry only 才将开发者可运行的服务器限制在名单内。按文档,Copilot 会在基础 URL 后追加 /v0.1,HISTOR 也提供了 Access-Control-Allow-Origin: *,允许 GET 和 OPTIONS。作者从未把它接到 Copilot 组织实测。30 条一致性抽样能支持字段兼容性,这一步离验证客户端会怎样读取和执行策略还有距离。
HISTOR 的公共副本收录官方注册表里的所有服务器,不做评分或筛选。即使观测状态很完整,直接把这个全量地址填进 Registry only,名单范围依然很大。公共实例也没有可用性承诺,每个地址每分钟限 600 次请求,响应可缓存 5 分钟。团队若要把注册表当作日常开发的准入入口,实际需要维护的是自己批准的名称范围。
能拿来做什么
- 把团队正在使用的 MCP 服务器名称写入
names.txt,用原文的python3 check_list.py names.txt做审批前初筛。脚本只需要 Python 3.9 或更新版本和标准库,清单有历史记录时还应核对lastStatus与lastObserved。 - 对返回
http-401的 GitHub 或 Notion 端点,用团队实际批准的账号连接并读取tools/list,把这次看到的工具清单作为审批依据。 - 如果团队要用 Copilot 的
Registry only,先用精确名称搭一个白名单副本,再用组织里的测试账号验证名单内服务器可用、名单外服务器受限。使用namespace/*时,要确认整个命名空间都在审批范围内。