Skip to content
FunCoding

Search

Search docs, Skills and MCP

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。