不改一行 API:把 Next.js 应用的 oRPC 过程直接变成 MCP 工具

piotrkulpinski · reddit · 2026-10-30

Dirstarter(付费 Next.js 目录站模板)作者分享了如何为应用构建 MCP 服务器,而不必为 agent 单写一套 API。

架构:从 Next.js 路由处理器跑两个 MCP 服务器——/mcp 公开只读(供助手检索目录信息),/api/mcp 藏在 bearer 密钥后允许增删改。应用已有的 oRPC 类型化过程只要加一个 meta.mcp 条目(名称、描述、注解)就变成工具,启动时注册表遍历路由并把 Zod 输入转成 JSON Schema。按过程权限自动分流:游客可调的进公开服务器,其余进管理端。工具调用直接复用过程,权限、限流、邮件、webhook 行为与 UI 完全一致。

让 agent 用得更好的细节:错误结果带错误码并列出非法字段,agent 会修正输入而非放弃;UI 中会发邮件的工具默认在 MCP 里不发;完全没有删除工具;服务器指令明确告知 agent 用户文本是数据不是指令;测试保证每个服务器不超过 25 个工具、25KB 定义(因有些客户端会把所有工具塞进上下文)。

实测 Claude Code 里从 URL 添加一条 listing 用了 7 次工具调用、54 秒。两个服务器均无状态,可跑在 serverless 上。

原文链接 →

「编程与Agent」频道最新

更多「编程与Agent」频道 AI 资讯 →