#只读数据

MCP Resources 实战：让服务端把 8 万行设计文档喂给 Agent，附四套客户端配置与13 行排查表

Tools 是「Agent 问你答」，Resources 是「你问Agent 答」——同一个 MCP Server 里，方向相反的两种能力，而且很多人在写 Server 时只实现了 Tools，漏掉了 Resources。结果是文档、规范、schema、日志这类只读数据只能靠 Agent 一个个调 Tool 去捞，每次捞都要过一次模型判断，成本高还不稳定。本文讲透MCP 四大原语里的第二个：Resources。涵盖 resources/list、resources/read、resources/templates/list 三个方法与 URI 模板机制（RFC 6570 展开规则），以及 Resource 与 Tool 的选型对照（把同一份数据做成 Tool 还是 Resource 的实测差异）。给出一个可运行的「设计文档中心」Server 完整实现（含 40+ 行 TypeScript，含分页、版本快照、访问审计），以及 Claude Code / Cursor / VS Code + Copilot / Trae 四套带中文注释的配置 JSON。三个实战场景：Agent 读设计文档回答「这个接口为什么这么设计」、按版本读取历史 schema 做迁移校验、把资源目录挂进 IDE 侧边栏。另含资源数量膨胀到 500+ 时的分页与 URI 命名规范、五条安全红线（为什么资源 URI 绝不能暴露绝对路径和凭据），以及 13 行故障排查表。