Accessing resources

📚 MCP 客户端资源读取功能学习笔记

核心概念：

• 资源请求机制 (Resource Request Mechanism):
• 客户端需要能够请求和获取 MCP 服务器上定义的资源。
• 通过在 MCP 客户端中添加 read_resource 函数来实现此功能。
• 该函数接收一个 URI (Uniform Resource Identifier) 作为输入，用于指定要获取的资源。

• read_resource 函数实现流程:
• 发起请求: 调用 await self. session. read_resource 向 MCP 服务器发送请求。
• 获取结果: 从返回的结果中提取资源内容 (contents)。
• 类型判断: 检查资源的 MIME 类型，以确定如何处理内容。
• 内容处理逻辑:
• 如果 MIME 类型是 application/json: 必须使用 json. loads() 将文本内容解析为 JSON 对象并返回。
• 否则: 直接返回原始文本内容（适用于单个文档等非结构化数据）。

• 设计原则与应用:
• 代码可重用性 (Reusability): read_resource 函数是 MCP 客户端的核心组件，它将被代码库中的多个地方调用（例如，用于获取文档列表，或获取文档内容以构建提示 Prompt）。
• 功能验证: 通过 CLI 测试验证了该功能，确认文档内容已成功读取并被发送至 LLM (Claude) 进行处理，无需额外调用工具。

关键术语对照：

• MCP Server → MCP 服务器
• Client → 客户端
• URI → URI (统一资源标识符)
• MIME Type → MIME 类型
• JSON Parsing → JSON 解析
• Resource → 资源

Takeaways

• 客户端通过 read_resource 函数向 MCP 服务器请求资源。
• 该函数接收 URI 作为输入，用于精确指定要获取的资源。
• 内容处理逻辑必须基于资源的 MIME 类型进行判断。
• 若 MIME 类型为 application/json，则需使用 json. loads() 进行解析；否则直接返回原始文本。
• read_resource 是 MCP 客户端的核心组件，具有高代码可重用性。