用MCP资源URI提供版本化只读文档

目标

让Agent按明确资源URI读取可追溯的只读文档。

步骤

1. 选择适合公开给客户端的文档集合，并定义版本和访问范围。 [mcp-resources]
2. 用 @mcp.resource("docs://{doc_id}") 注册读取函数，确保URI占位名与函数参数同名。 [mcp-resources]
3. 为文本、JSON或二进制返回值声明正确 mime_type；资源只在 resources/read 时调用，不会因list而执行。 [mcp-resources]
4. 在更新文档时通过版本URI或明确版本元数据保留可复核来源。 [mcp-resources]
5. 用客户端列出并读取资源，确认读取结果对应期望版本且不会改变源文件。 [mcp-resources]

验证方式

客户端应能发现资源、读取特定版本并对不存在或无权资源得到安全错误。

故障处理

若资源无法读取，检查URI规范化、MIME类型以及列表和读取handler上的授权。