MCPgraphy：一个教会AI何时不该调用工具的代理

MCP 工具调用的盲区与 MCPgraphy 的解法

MCP 服务器交到你手里的东西，我一直觉得缺了一块。工具列表给得挺全：名称、描述、参数 schema，都齐了 来源：GitHub 仓库。但有一个问题它从来不回答：这个工具，现在到底能不能用？智能体拿到这份清单，就闷头去试了。结果就是编辑一个不存在的文件、发布一个从没测过的版本、移动一个已经关闭的工单，然后被错误弹回来，再重试。有时候重试的那一下，才是真正造成伤害的。服务器明明知道答案，就是不说。

MCPgraphy 的做法不一样。它把自己塞在智能体和服务器中间，工具照常穿过去，参数一个不动 来源：GitHub 仓库。但它多了一件事，从智能体自己的调用记录里学。哪次调用成功，哪次失败，它都记下来，然后反推出什么状态下哪些工具是有效的 来源：GitHub 仓库。等下一次坏调用要发生，它先警告，或者直接拦下来 来源：GitHub 仓库。

接入方式也不挑。mcpgraphy wrap --adapter adapter.json --policy warn -- npx -y @modelcontextprotocol/server-filesystem ~ /work 这一条命令，把任何 MCP server 包起来就行 来源：GitHub 仓库。默认策略是 warn，不是 block，我猜这是有意为之，毕竟工具调用的失败原因有时候很复杂，一上来就切断容易误伤 来源：GitHub 仓库。而且它不需要密钥，数据也不离开本机 来源：GitHub 仓库。

量化证据与基准测试

仓库的维护痕迹挺清楚。24 个提交，examples、experiments、tests 三个目录分门别类放着，CHANGELOG.md、SECURITY.md、CONTRIBUTING.md 都在 来源：GitHub 仓库。一个刚上 Show HN 的项目，把这些文件备齐，至少说明作者是想长期养的。不过 24 个提交不算多，我猜这个项目还是早期，功能框架搭起来了，剩下的要靠真实使用者的反馈去磨。

视频 explainer-voiced.mp4 只有 1 分 48 秒，但讲了三件事：工具调用哪里出了问题、代理怎么从智能体已有的调用里映射工具、一个真实 GPT 智能体跑在它后面之后有什么变化 来源：GitHub 仓库。作者特别注明，视频里的每个数字都来自基准测试，不是演示效果 来源：GitHub 仓库。

安装走的是 pip install mcpgraphy，依赖用 uv.lock 锁定 来源：GitHub 仓库。这些技术细节不复杂，但能看出作者对可复现性有要求。不过说实话，我没有在仓库里找到基准测试的具体数字，比如成功率提升了多少、错误调用减少了多少。视频里说有，我没看视频，所以这部分我不敢下判断 来源：GitHub 仓库。

多源交叉验证：HN 社区反应与项目定位

HN 上的标题写的是"learns when your agent's MCP tools work"，这个表述偏简洁 来源：Hacker News。README 里就说得具体多了："从智能体自己的调用中学习哪些工具在哪些状态下有效" 来源：GitHub 仓库。我觉得这个差异值得注意，HN 标题面向的是想快速抓重点的人，README 才把机制讲明白。

但 HN 那边的反应很冷淡。我写这篇的时候，它只有 1 分、0 条评论 来源：Hacker News。一个宣称用真实 GPT 智能体跑过基准、还录了 1 分 48 秒讲解视频的项目，在社区里激不起什么水花。这个反差让我有点困惑。我不确定是项目本身的问题，比如基准测试的说明不够直观，还是 HN 的推荐机制就没给它机会。我见过不少类似的项目，作者花大力气做了很扎实的东西，但 presentation 跟不上，社区就看不见。MCPgraphy 的 README 写得挺细，但 HN 上的标题太素了，抓不住人。

不过 README 里有两处细节让我觉得作者想得比较周到。一处是"同样的工具、同样的参数"，意思是代理不会改变工具调用的语义，智能体拿到的还是原来的东西 来源：GitHub 仓库。另一处是 --policy warn 默认只警告不阻断，给使用者在学习初期留了缓冲 来源：GitHub 仓库。工具调用的失败有时候是学习成本，先警告再调整，比一上来就禁掉要稳。这让我想到很多工具类项目一上来就想着"自动纠错"，但智能体的调用失败原因往往很复杂，有时候参数对但上下文不对，强行阻断反而会干扰它。

原文：

Show HN: MCPgraphy – a proxy that learns when your agent's MCP tools work · 来源：Hacker News

作者：itfan123 值班编辑 · 发布于 2026年11月3日