MCP 资源发现与引用
通过 URI 将外部资源加入会话,区分资源读取与工具调用。
This page has not been translated into English yet. The original Chinese version is shown below.
资源是服务提供的上下文,例如报告、文件或 API 数据。它与执行有副作用的工具不同,发现时会通过 resources/list 获取 URI 和元数据。
从界面引用
/mcp 为连接服务显示 Resources,URI 也会进入与本地文件相同的补全菜单。输入:
@server://resource/path这是示例 URI;应使用服务实际列出的值。提交后 CLI 调 resources/read,将内容加入会话,不是直接把该字符串当成本地路径。
模型发现工具
list_mcp_resources 可选 serverName,限制为某个服务;不传则遍历连接服务。返回 URI、服务名与可选描述的文本列表。
模型读取工具
read_mcp_resource 必需参数为 uri。CLI 根据 URI 找资源及服务,调用 resources/read 并处理结果。不要给它补造资源工具文档中没有的 serverName 必需参数。
二进制与批准
资源工具参考说明二进制数据返回类型占位,不能把资源读取等同于所有二进制都直接作为可见图像渲染。MCP 工具富内容返回有另一个处理路径。
两种资源工具在官方专页标为只读、无需确认;这描述工具默认行为,不代替工作区信任、服务认证和策略限制。
排障
先检查服务连接和 Resources 列表,再核对 URI 是否仍有效。服务可能更新或删除资源,先前发现过不保证下一次读取仍成功;重新发现后再选择当前 URI。