跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

MCP 资源发现与引用

通过 URI 将外部资源加入会话,区分资源读取与工具调用。

资源是服务提供的上下文,例如报告、文件或 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。