知识库建好只是第一步，下一步是让 Codex、Cursor 这些 agent 能搜、能读、还能安全地写。我的做法是别把仓库钥匙整个塞给 agent，给它开个柜台：用 FastMCP 写一个一百多行的本地 MCP server，把 Sphinx + MyST + Mermaid 的 Markdown 知识库包成五个工具——目录、搜索、读、写、代码图查询。路径白名单、frontmatter 校验、原子写入、审计流水全在柜台上，写操作不提供删除。再把 graphify 和 Understand-Anything 的代码知识图谱挂上来，让 agent 查图而不是 grep。代码和输出都在 FastMCP 4.1.0 上逐工具验证过，可以整段抄走。