MCP Checkup
[
]
MCP Checkup
[
]
菜单
服务器目录
给 agent
给维护者
定价
登录
English
服务器目录
给 agent
给维护者
定价
登录
English
RSS
查看全部已观测 server →
手记
我们检查 MCP server 时观测到的现象,以及对所发现问题的修复。
看看我们追踪的 server 上观测到了什么 →
2026-11-06
tools/list 分页:nextCursor,以及被当成 1,000 个的 3,676 个工具
MCP 列表分页在 2025-11-25 和 2026-07-28 两个版本里怎么工作,一段数页数的 curl 脚本,server 和客户端常犯的错,以及我们自己犯过的只读第一页的错。
maintainers
protocol
troubleshooting
2026-11-05
2026 年 10 月下旬 MCP server 观测
2026 年 10 月 31 日,5,954 个远程 MCP endpoint:59% 完整签名,33% 以「需登录」签名,8% 未签名;协议版本分布,以及 902 次工具列表变化。
data
attestations
2026-11-03
把远程 MCP server 接进 Claude 和 Cursor,以及连不上时该查什么
在 Claude(自定义连接器)和 Cursor(mcp.json)里添加远程 MCP server 的步骤,2026 年 10 月 25 日对照两家官方文档核对;以及连不上时的排查顺序。
maintainers
protocol
troubleshooting
2026-10-30
MCP 授权实战:401、WWW-Authenticate 与受保护资源元数据
受保护的 MCP server 在客户端拿到任何 token 之前必须给它看什么:401 质询、RFC 9728 元数据文档和授权服务器发现;外加常见的配置错误,以及每一步对应的 curl 命令。
maintainers
protocol
troubleshooting
2026-10-27
MCP 错误码详解:协议错误与工具错误
MCP server 该发哪些 JSON-RPC 错误码和 MCP 自定义错误码,工具调用失败什么时候该改用 isError 结果,以及每种情况下模型最终看到的是什么。
protocol
troubleshooting
2026-10-25
11.9 万份签名的 MCP server 检测结果:在线情况与工具列表漂移
截至 2026 年 10 月 21 日的一个月里,我们的探测器在 5,916 个公开 MCP endpoint 上看到了什么:多常应答、工具列表多常变化、用的是哪些协议版本。
data
attestations
2026-10-25
调用不存在的工具:该回 JSON-RPC 错误,而不是 isError
一位维护者修掉了报告上唯一一项观察到的风险。error_taxonomy 这项检查发什么、期待什么,怎么用 curl 自测,以及 3,309 个 server 里有多少用 isError 回答未知工具。
maintainers
protocol
troubleshooting
2026-10-23
在 Claude 里用 MCP Checkup:接入 MCP server 之前先查一查
MCP Checkup 已收录在 Claude 的连接器目录里。怎么添加;接入一个 MCP server 之前可以问它什么、会得到什么;以及它不做什么。
directory
attestations
2026-10-21
2026 年 10 月 MCP server 观测
2026 年 10 月 21 日,5,916 个远程 MCP endpoint:60% 完整签名,32% 以「需登录」签名,8% 未签名;协议版本分布,以及 1,487 次工具列表变化。
data
attestations
2026-10-20
Streamable HTTP 与 SSE:把远程 MCP server 迁到当前的传输方式
HTTP+SSE(2024-11-05)和 Streamable HTTP 有什么不同,2026-07-28 又改了什么,迁移期间怎么让老客户端继续能用,以及验证迁移的 curl 命令。
protocol
maintainers
2026-10-17
从一个循环到十九条消息:先测清 Cloudflare Queues 怎么扩,再把检查放上去
探测器原来一台接一台地检查。我们先测了队列的 consumer 怎么扩容,拟合了一个模型,验证它的预测,然后才改成每轮 19 条消息。
engineering
scheduling
2026-10-17
我们的第一张图表上线前错在三处
目录统计页上有一张小折线图:近 90 天每日签名结果数。审查中发现,它覆盖的是最近 90 行而不是 90 天;它的时间戳可能被按错误的时区来读;在宽屏上,折线也没有对准下面的标签。三处都在合并前改好了。
engineering
2026-10-16
MCP server 返回 406 Not Acceptable:是什么意思,怎么修
Streamable HTTP 下的 MCP server 为什么会回 406,怎么用 curl 复现,以及在客户端、服务端和中间的代理层各自怎么修。
troubleshooting
protocol
2026-10-16
一个远程 MCP server 暴露多少个工具?中位数是 7 个
在我们能读到工具列表的 1,903 个远程 MCP server 里,工具数的中位数是 7;40% 只有 5 个或更少,28 个有 100 个或更多。
data
protocol
2026-10-16
停不下来的 spinner:back/forward cache 与一个回不去的等待状态
在首页提交检查后按返回,按钮回来仍是禁用的,标签停在计时中途,怎么都恢复不了。原因是浏览器的 back/forward cache 把页面恢复在等待中途。修法:带 pageshow 复位的小控制器,并删掉 beforeunload 监听器。
engineering
2026-10-16
存不进数据库的那个 null byte
我们跟踪的一台 MCP server 在工具 schema 里发布了一个含 \u0000 的合法正则表达式。PostgreSQL 存不下这个字符,于是四天里,这台 server 的每个快照都在写完头行后失败。我们怎样修好它而不改写证据。
engineering
methodology
2026-10-15
平台取消了一轮又重跑一遍,/status 因此返回了 52 分钟的 HTTP 503
被平台取消的探测轮次会留下一个永远不会结束的任务,/status 曾因此报告「卡住」长达 52 分钟。现在什么才算卡住,以及我们保留了什么。
engineering
scheduling
2026-10-15
一条有 2% 的时候会失败的测试
我们测试套件里的一道开放重定向防护会随机变红,大约五十次一次。原因是对一个 43 字符的 token 做了子串检查。第一个修法会让这道防护失明。教训在于:一道防护的注释应当给读者交代什么。
engineering
2026-10-15
我们的 CI 构建网站时不给任何密钥,这是有意的
类型检查和单元测试都是绿的,而 pages 目录里一个误放的测试文件却会让生产构建失败。所以 CI 现在真的跑一次 astro build,而且不注入任何 secret,因为任何预渲染路由都不允许在构建期读数据库。
engineering
2026-10-14
MCP server 多久换一次工具?两周内,每五台里有一台换过
我们每 12 小时读一次 1,893 个远程 MCP server 的工具列表。22% 至少变过一次;大多数变化只是新增工具,而且多半集中在少数 server 上。
data
maintainers
2026-10-14
登录坏了两天,却没有任何日志记下
9 月 12 日到 14 日,mcpcheckup.com 上 Google 登录和邮件链接都不能用,服务器端日志却毫无异常。原因是一次刻意从干净检出做的构建,里面有两个变量是空的。怎么修的,以及现在拒绝再部署这种构建的那道关卡。
engineering
2026-10-14
在第 67 秒被取消的那一轮探测
三轮探测中途停下,留下的 server 半小时后才被重新检查。取消是平台的寻常行为,半小时则来自我们自己的守卫。这个窗口怎样从 30 分钟缩到 15 分钟,又为什么没有缩到 10 分钟。
engineering
scheduling
2026-10-13
远程 MCP server 上线清单
远程 MCP server 上线前要查的十三项,从 TLS 到每次发布的工具集指纹,每一项都写明为什么重要、用什么命令验证。
maintainers
protocol
2026-10-13
对读它的 agent 发号施令的工具描述
AI agent 选工具之前,会读每个 MCP 工具的描述。我们的探测器会标记这段文字里的几种模式:26,575 个工具里有 409 个命中。
data
protocol
2026-10-13
每个生产迁移现在都执行两次,第一次我们主动回滚
MCP Checkup 怎样修改一个正在服务的 Postgres 的表结构:先在一个事务里完整干跑一遍,以一个故意抛出的异常结束,再正式应用。干跑测量什么,以及它这个月抓到的两件事。
engineering
2026-10-13
我们向 1,144 台 MCP server 调用了一个编造的工具
探测器唯一的一次工具调用点名一个编造的工具,看 server 怎样拒绝。此前这项检查把 58% 有签名结果的 server 记为风险,却说不出它们答了什么。现在我们记录七类答复;被记为风险的 server,十台里有九台答的是同一类。
methodology
protocol
data
2026-10-12
MCP server 连不上?按你看到的报错逐条排查
2,980 个 MCP endpoint 在最近一次 run 里停在哪一步,每种报错是什么意思,以及在你自己的 server 上复现它的 curl 命令。
troubleshooting
maintainers
2026-10-12
MCP server 说「不」的几种方式,以及哪些会算到它头上
拒绝不等于失败。MCP Checkup 区分格式规范的 JSON-RPC 错误、带有真实质询的凭据门控、新版协议的拒绝,以及格式不规范的拒绝,并分别记录。这里是探测器使用的分类。
methodology
protocol
2026-10-12
是哪份代码检查了你:suite_commit 与 suite_digest
每个签名结果都写明产出它的检查套件 commit,以及这个 commit 下检查套件目录树的摘要,任何拿到公开仓库的人都能用一条命令复算。这个值怎么生成,怎样防止探测器带着过期的值部署,以及较早的结果做不到什么。
attestations
methodology
2026-10-11
七千份工具快照复制进冷存储,一个字节都没变
我们把 7,102 份工具快照从数据库复制成冷存储里的 gzip 对象。我们怎么核对这些副本,以及哪些还没有复制。
engineering
data
2026-10-11
为什么未认领的 server 每 12 小时探测一次
MCP Checkup 每天检查未认领的 server 两次,认领后 Free 档每 8 小时一次,Indie 档每 15 分钟一次。每个数字背后的理由,检测节奏能告诉你什么、不能告诉你什么,以及付费能改变什么、不能改变什么。
methodology
scheduling
2026-10-11
首页上的检查不会在目录里留下痕迹
在 MCP Checkup 首页贴入一个 MCP endpoint,你会得到一个一次性的、会过期的结果页。这次检查做什么,刻意不做什么,以及为什么一次试用永远不能自己变成一个公开页面。
methodology
trial
2026-10-10
上线之前,怎么测试一个 MCP server
从外部逐层测试一个远程 MCP server:传输、握手、tools/list、错误、鉴权和工具描述,每一步都有可以直接复制的 curl 命令。
maintainers
protocol
troubleshooting
2026-10-10
只在并行时才出现的 bug:四台 server 在零点几秒内被检查了两次
探测器改为并行后的头两轮,把四台 server 各检查了两次,间隔 0.11 到 0.24 秒。为什么串行时从没撞上、为什么先回滚、怎么修的。
engineering
scheduling
2026-10-10
你的 MCP server 可能已经在一个你从没注册过的目录里
MCP Checkup 收录它观测到的远程 MCP server,不管有没有人来登记。server 怎样进入目录,页面说什么、拒绝说什么,怎样接手这个页面,以及怎样要求移除。
directory
maintainers
2026-10-10
认领 MCP server 页面:我们核验的是地址,不是记录
MCP Checkup 怎样决定谁能代表一个 server 页面说话。证明锚定在 endpoint 的主机本身,用一个 well-known 文件或一条 DNS TXT 记录,所以认领不能在记录之间转移,也不能靠你恰好掌控的代码仓库伪造。
maintainers
claiming
2026-10-09
我们的博客不肯存下的那些词,以及这篇文章为什么写不出它们
自 2026-10-08 起,我们博客的新文章存在数据库里,触发器拒绝发布任何含判定用词的文章,这一篇也不例外。
engineering
methodology
2026-10-09
为什么 MCP Checkup 不运行你的代码(以及这对 stdio server 意味着什么)
远程 MCP server 是一个地址;stdio server 是一个软件包,检查它就意味着在某个人的机器上执行它。这条线今天划在哪里,以及我们正在朝之努力的三层设计。
methodology
stdio
2026-10-09
签名证明能证明什么,不能证明什么
MCP Checkup 的探测 run,除非因故不予签名(页面会写明),都会产出一份签名的 DSSE envelope。签名覆盖什么、怎样标识跑的是哪份代码、第三方怎样自己核验,以及签名完全不涉及的事。
methodology
attestations
2026-10-08
我们为什么不给 MCP server 打分
MCP Checkup 只展示我们对一个 MCP server 观测到的内容,拒绝把它折算成一个数字或一个等级。原因是结构性的,不是出于谦虚。
methodology
maintainers
2026-10-04
发布前,怎么测你的 MCP server
把端点贴进 MCP Checkup 首页,就能看到 agent 第一次连上你的 server 时看到的东西:握手、tools/list、错误形状、重定向、工具文字。每项检查能说明什么,结果为什么不签名、24 小时后过期,以及基线检查为什么显示 UNVERIFIED。
methodology
trial
2026-10-01
你的 agent 自己加了一个 MCP server。关于它,你到底知道什么?
个人 agent 已经会自己添加 MCP server。server 怎样处理 agent 发给它的内容,从外面谁也看不到;但有些事可以查:它有没有应答、提供哪些工具、工具有没有变。我们目录里的 1,470 台 server,30 天内有 236 台变过。
directory
data
methodology
2026-09-30
MCP server 最后用哪个协议修订答复我们?
每次探测开始时都要先商定一个协议修订,签名结果会记下商定的结果。在最新结果有签名的 1,004 台 server 中,580 台落在 2025-06-18(我们回退时提出的修订),394 台落在 2026-07-28。这两个数说明了什么,没说明什么。
protocol
data
methodology
2026-09-30
探测器五个小时什么都没跑,也没有任何东西告诉我们
2026-09-23,每五分钟启动一次探测器的调度器停止了调用。五小时后,一次与此无关的部署让它恢复;又过了将近四小时,我们才在按小时统计的数字里发现。发生了什么,关于原因我们能说什么、不能说什么,以及我们加上的两个信号。
scheduling
engineering
2026-09-30
每 10 个公开的 MCP 端点里,有 3 个先要密钥
我们观测的 2,282 个公开 MCP 端点中,有 694 个在匿名握手时就回了认证质询。我们从不携带凭据,所以从没见过它们的工具。没有密钥时我们还能观测到什么,以及这些观测说明不了什么。
directory
protocol
data
2026-09-30
探测器有时会扣下的那一次调用
为了看 MCP server 怎样拒绝一个不存在的工具,我们的探测器会调用一个「保留给不应存在的工具」的名字。server 完全可以定义这个名字,所以探测器先读工具列表,凡是无法排除这种可能,就扣下这次调用。2026-09-30,2,282 个公开端点里有 838 个的调用被扣下。
methodology
protocol
data
2026-09-30
一个只可能显示 100% 的比率
2026-09-23,我们目录里的 833 台 server 显示的可达比率全都是 100%。这不是因为它们每天都答复了我们,而是我们的计法造成的。我们在核对一篇博客时发现了这个问题。哪里错了、改了什么、现在这个数是什么样子。
methodology
data
engineering
2026-09-14
为什么我的 MCP server 显示"已观测,未签名"?
导致 MCP Checkup 报告显示"已观测,未签名"的五个协议层原因——四个在 server 自己的配置里,一个是我们探测器的 bug,已发现并修复。前三个各附一条 curl 自测命令和修法,另外两个说明怎么自查。
troubleshooting
faq