Defining resources

📚 MCP 服务器资源 (Resources) 学习笔记

一、 核心概念

• MCP 资源 (Resources)： 允许 MCP 服务器向客户端暴露数据和功能。
• 功能目标： 实现用户在消息中提及文档（例如 @report. pdf）的功能。
• 实现机制（两部分）：
• 自动补全 (Autocomplete)： 用户输入 @ 时，MCP 服务器自动提供可用文档列表。
• 内容获取： 用户提交包含提及的消息时，MCP 服务器自动获取指定文档的内容，并将其插入到发送给 Claude 的提示词 (Prompt) 中。

二、 资源类型

• 直接资源 / 静态资源 (Direct/Static Resources)：
• 具有固定的 URI (统一资源标识符)。
• URI 永远不变，例如：docs://documents。
• 模板化资源 (Templated Resources)：
• URI 中包含一个或多个参数（通配符）。
• 示例：docs://documents/{doc_id}。
• 工作原理： 当客户端请求该资源时，MCP SDK 会自动解析 URI 中的参数，并将其作为关键字参数 (Keyword Argument) 传递给服务器上的函数。
• 用途： 适用于需要选择或定制数据的场景。

三、 资源实现流程

• 定义资源： 在 MCP 服务器中定义资源，包括 URI 和返回的数据类型 (MIME Type)。
• 示例 1 (列表)： URI docs://documents → 返回文档 ID 列表 (MIME Type: application/json)。
• 示例 2 (内容)： URI docs://documents/{doc_id} → 返回单个文档内容 (MIME Type: text/plain)。
• 客户端请求： 客户端通过 MCP 客户端向服务器发送“读取资源请求” (Read Resource Request)，请求中包含目标 URI。
• 服务器处理： MCP 服务器根据 URI 运行相应的函数，并返回“读取资源结果” (Read Resource Result)。
• 数据接收： 客户端接收结果，并根据返回的 MIME Type 进行处理（如 JSON 反序列化或直接显示文本）。

Takeaways

• MCP 资源是允许服务器向客户端暴露数据和功能的机制，主要用于实现消息中的文档提及功能。
• 资源实现包含两个核心部分：自动补全（提供可用文档列表）和内容获取（将文档内容插入到发送给 Claude 的提示词中）。
• 资源分为直接资源（URI固定不变）和模板化资源（URI包含参数，MCP SDK 会自动解析参数并传递给服务器函数）。
• 资源处理流程是客户端发送“读取资源请求”，服务器运行相应函数并返回“读取资源结果”，客户端根据 MIME Type 进行数据处理。