开源 FrontMCP 自建文档 MCP 服务器：按 lockfile 锁定版本

DavidAntoon · reddit · 2026-10-20

FrontMCP 作者分享用自研开源 TypeScript 框架替换 Mintlify 文档 MCP 服务器的完整经验：

• 核心设计:按 release 提供文档快照——每个发布版本打 git tag,构建为 Markdown 页面、分节索引、全文搜索与 API 索引(当前版本 178 页、3662 节、4737 条 API,共服务 11 个版本)。Agent 通常不知道项目用哪个版本,服务端指示它先调 resolveversion,以 lockfile 为准(package.json 只有版本范围)。
• 工具设计:把 agent 原来用 grep/tree/head 做的事变成专用工具——searchdocs、getpage、lookupapi、getexample、whatschanged(回答「两个版本之间改了什么」这一升级问题的起点)。
• 踩坑经验:
• MCP 端点无法 301 重定向,客户端不跟随 POST 重定向,只能别名保留旧地址;
• 搜索索引不要收录代码块,索引从 5.5MB 降到 3MB 且查询质量不变;
• 避免重复 payload(text 与 structuredContent 重复发送同一页);
• 构建耗 CPU 约 27ms,超出 Workers Free 的 10ms 限制,只能上付费版;
• 限流放在边缘(Cloudflare Rate Limiting binding,120 次/分钟)而非 isolate 内;
• 把 tools/list 当 API 对待,快照测试失败即中断构建,部署后脚本按两个协议版本以真实客户端连接验证。

已入官方 MCP Registry,无需密钥即可用 claude mcp add 接入。

原文链接 →

「编程与Agent」频道最新

• Agent 记忆文件该设多大？Reddit 网友实践：压到 200 行内每周合并 — bayvo · 2026-10-20
• Mistral Vibe CLI 3.0 发布:终端 UI 改用 Rust 重写,首帧仅需 72ms — onetwoval · 2026-10-20
• Agent 答错不怪模型：数据脏才是主因，用 20-30 个真实问题做审计 — SUPERSAIIYANNN · 2026-10-20
• 用 Nemotron 3.5 Super VL 做聚餐分账应用:推理成本值不值 — HowDevelop · 2026-10-20
• Mila 提出 RSA 测试时扩展法，Gemini 3 Flash 冲近 ARC-AGI-2 榜首 — morgymcg · 2026-10-20
• Sparrow 本地部署将 MRI 报告转结构化数据，敏感医疗数据不出内网 — andrejusb · 2026-10-20

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