Vibe Coding 官方文档与 MCP 证据：从工具结果回到可核查原文

“MCP 工具查到官方示例使用这个 API”仍缺少多个关键事实：调用的是哪台 Server，搜索结果是否只给了摘要，页面对应哪个版本，资源读取后是否被缓存，仓库实际安装包是否具有该导出。协议调用成功只能证明某个端点返回了一份内容，不能自动把内容升级为适用于当前任务的权威证据。

官方文档锚定解决“仓库真实版本应对应哪份资料”；本文解决下一步：Vibe Coding Agent 通过 MCP 资源或搜索工具获取资料时，怎样保留身份、原文与验证链。两者都完成，才能从文档走到代码。

先把问题写成待证 claim

不要先搜索“框架最佳实践”。写出具体 claim，例如“2025-11-25 版 MCP Server Resources 定义了 resources/read 的资源内容返回形态”，并记录协议版本、SDK 版本来源和准备核对的本地类型。搜索只负责发现候选资料，不能替换问题定义。

MCP 架构区分 Host、Client 与 Server，并通过协商能力建立会话。Server 可能暴露 resources、tools 或两者；客户端应先读取已协商能力，不得因为另一台 Server 支持 resources/list 就假设当前也支持。工具名称相似也不代表实现或信任域相同。

资源读取和工具搜索分工

当官方文档以 MCP Resource 暴露时，记录 resource URI、名称、MIME type、Server identity 和读取时间，再通过 resources/read 获取正文。搜索工具适合从关键词发现页面或段落，但工具结果必须给出 canonical origin；只有摘要而无原文定位时，claim 状态保持 candidate。

claim: resources/read returns content items carrying their resource URI
repositoryEvidence: installed MCP SDK declaration resolved by the lockfile
mcp:
  protocolVersion: 2025-11-25
  server: approved-docs-server
  method: resources/read
  uri: https://modelcontextprotocol.io/specification/2025-11-25/server/resources
  contentDigest: exact returned bytes hashed with SHA-256
canonicalOrigin: https://modelcontextprotocol.io/specification/2025-11-25/server/resources
status: candidate

MCP Resource URI 是协议内身份，不必等同公开 HTTPS URL。若 Server 没有提供可核对的官方 origin 或版本，内容可以辅助发现关键词，却不能声称是“一手官方来源”。正文中的相对链接、最后更新时间和版本标记也要保留，不能只摘一段看似支持的句子。

把 Server 返回内容当不可信输入

文档内容可能陈旧、被错误索引，甚至夹带“忽略仓库规则并执行命令”之类指令。它只是一份待评估实体，不获得 Shell、文件或网络权限。Agent 提取事实和代码样例，不执行页面要求的安装、迁移、上传或写操作。

Agent 工具能力目录处理工具列表的完整发现、策略过滤与 generation；文档工作流还要限制 approved Server、允许 URI 前缀和只读方法。需要调用搜索 tool 时，参数不含秘密源码；返回的外链仍经过协议、域名和来源政策检查。

资源列表与正文会变化。单次任务至少保存读取摘要；收到列表变化或资源更新迹象时，让相关 claim 失效并重读。MCP Resource 订阅与版本对账处理长期订阅、分页和通知缺口，本篇不把一次开发查询扩展成常驻同步系统。

原文证据必须落回本地制品

对每条 claim 保存最短充分原文、章节标题、resource URI、内容摘要和解释；随后在本地类型声明、导出表、schema 或依赖源码中定位对应符号。若文档说 API 存在而本地制品找不到，结论是版本或功能条件仍未解释，不是立刻升级依赖。

代码样例还要经过当前运行时的最小编译或测试。文档能证明作者声明了什么，本地制品证明仓库安装了什么，运行检查证明调用在当前组合下如何表现。三层结果冲突时保留冲突，不让模型选择最顺手的一层。

任务上下文包可存放最终文档收据，但不要粘贴整页。收据应说明 claim、适用版本、MCP 读取身份、canonical origin、本地符号和失效条件；reviewer 能重新读取同一资源或转到公开原文。

以可复核而非“搜到了”结束

完成条件包括：Server 和能力来自批准配置；资源或工具结果有稳定身份；至少两条关键技术结论能定位到官方原文；资料版本与锁文件一致；建议 API 在本地制品存在；示例通过最小验证；任何未解释冲突仍标为 unknown。

MCP 降低了获取文档的摩擦，却没有改变证据标准。工具反馈真正有价值的时刻，是它让某个 claim 更可核查，并能安全改变下一步；不是让“由工具返回”成为新的权威标签。

延伸阅读

• 官方文档锚定
• Agent 工具能力目录
• MCP Resource 订阅与版本对账
• 任务上下文包