单文件中的零依赖 MCP 服务器：协议实际需要什么

Calyx AI 的服务器是一个紧凑的 119 行 Node.js 应用程序，旨在为模型上下文协议 (MCP) 执行两个特定的内容验证检查：根据“事实文件”确认草稿中的数字并验证链接功能。开发人员选择直接针对 MCP 规范构建此服务器，绕过官方 SDK 以避免依赖树，并且它仅导入 `node:fs` 和 `node:readline` 用于其标准输入/输出 (stdio) 传输。

其开发的一个关键方面涉及正确实施 MCP 规范的错误处理。最初，服务器将所有失败，包括协议级别问题（例如未知工具名称或无效参数），都视为“工具执行错误”，并以 `isError: true` 结果表示。然而，MCP 规范将这些与“协议错误”区分开来，后者是针对协议本身使用问题的普通 JSON-RPC 错误。

开发人员修改了服务器以符合规范，为协议违规分配了特定的 JSON-RPC 错误代码。例如，-32602 表示错误调用（例如，缺少草稿），-32601 表示未知方法，-32603 表示其他意外抛出。此更改确保服务器准确区分客户端协议误用与在识别的工具操作期间发生的失败，这对于稳健的客户端-服务器通信至关重要。

该服务器导出其检查功能以进行测试，并已确认可与 Claude Code 配合使用。其工具返回纯文本结果（“PASS”或“FAIL”）的设计决策被认为是模型将如何解释输出的选择，而不是测量的性能结果。