资源是模型上下文协议(MCP)中的核心原语，允许服务器暴露可以被客户端读取并用作 LLM 交互上下文的数据和内容。
资源设计为应用程序控制，这意味着客户端应用程序可以决定如何以及何时使用它们。 不同的 MCP 客户端可能以不同方式处理资源。例如：
  • Claude Desktop 目前要求用户在资源可以使用之前明确选择它们
  • 其他客户端可能基于启发式自动选择资源
  • 某些实现甚至可能允许 AI 模型本身决定使用哪些资源
服务器作者在实现资源支持时应该准备好处理这些交互模式中的任何一种。为了自动向模型暴露数据，服务器作者应该使用模型控制的原语，如工具。

​
概述

资源代表 MCP 服务器想要向客户端提供的任何类型的数据。这可以包括：
  • 文件内容
  • 数据库记录
  • API 响应
  • 实时系统数据
  • 截图和图像
  • 日志文件
  • 等等
每个资源都由唯一的 URI 标识，可以包含文本或二进制数据。

​
资源 URI

资源使用遵循以下格式的 URI 标识： 
[protocol]://[host]/[path]
例如：
  • file:///home/user/documents/report.pdf
  • postgres://database/customers/schema
  • screen://localhost/display1
协议和路径结构由 MCP 服务器实现定义。服务器可以定义自己的自定义 URI 方案。

​
资源类型

资源可以包含两种类型的内容：

​
文本资源

文本资源包含 UTF-8 编码的文本数据。这些适用于：
  • 源代码
  • 配置文件
  • 日志文件
  • JSON/XML 数据
  • 纯文本

​
二进制资源

二进制资源包含 base64 编码的原始二进制数据。这些适用于：
  • 图像
  • PDF
  • 音频文件
  • 视频文件
  • 其他非文本格式

​
资源发现

客户端可以通过两种主要方法发现可用资源：

​
直接资源

服务器通过 resources/list 端点暴露具体资源列表。每个资源包括： 
{
  uri: string;           // 资源的唯一标识符
  name: string;          // 人类可读的名称
  description?: string;  // 可选的描述
  mimeType?: string;     // 可选的 MIME 类型
}

​
资源模板

对于动态资源，服务器可以暴露URI 模板，客户端可以使用这些模板构建有效的资源 URI： 
{
  uriTemplate: string;   // 遵循 RFC 6570 的 URI 模板
  name: string;          // 此类型的人类可读名称
  description?: string;  // 可选的描述
  mimeType?: string;     // 所有匹配资源的可选 MIME 类型
}

​
读取资源

要读取资源，客户端使用资源 URI 发送 resources/read 请求。 服务器响应包含资源内容列表： 
{
  contents: [
    {
      uri: string;        // 资源的 URI
      mimeType?: string;  // 可选的 MIME 类型

      // 其中之一：
      text?: string;      // 用于文本资源
      blob?: string;      // 用于二进制资源（base64 编码）
    }
  ]
}
服务器可能在一个 resources/read 请求的响应中返回多个资源。例如，当读取目录时，这可以用于返回目录中的文件列表。

​
资源更新

MCP 通过两种机制支持资源的实时更新：

​
列表变更

服务器可以通过 notifications/resources/list_changed 通知客户端其可用资源列表发生变化。

​
内容变更

客户端可以订阅特定资源的更新：
  1. 客户端发送带有资源 URI 的 resources/subscribe
  2. 当资源发生变化时，服务器发送 notifications/resources/updated
  3. 客户端可以使用 resources/read 获取最新内容
  4. 客户端可以使用 resources/unsubscribe 取消订阅

​
示例实现

这是一个在 MCP 服务器中实现资源支持的简单示例： 
const server = new Server({
  name: "example-server",
  version: "1.0.0"
}, {
  capabilities: {
    resources: {}
  }
});

// 列出可用资源
server.setRequestHandler(ListResourcesRequestSchema, async () => {
  return {
    resources: [
      {
        uri: "file:///logs/app.log",
        name: "应用程序日志",
        mimeType: "text/plain"
      }
    ]
  };
});

// 读取资源内容
server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
  const uri = request.params.uri;

  if (uri === "file:///logs/app.log") {
    const logContents = await readLogFile();
    return {
      contents: [
        {
          uri,
          mimeType: "text/plain",
          text: logContents
        }
      ]
    };
  }

  throw new Error("未找到资源");
});

​
最佳实践

实现资源支持时：
  1. 使用清晰、描述性的资源名称和 URI
  2. 包含有帮助的描述以指导 LLM 理解
  3. 在已知时设置适当的 MIME 类型
  4. 为动态内容实现资源模板
  5. 对频繁变化的资源使用订阅
  6. 优雅地处理错误并提供清晰的错误消息
  7. 考虑对大型资源列表进行分页
  8. 在适当时缓存资源内容
  9. 在处理前验证 URI
  10. 记录您的自定义 URI 方案

​
安全考虑

暴露资源时：
  • 验证所有资源 URI
  • 实现适当的访问控制
  • 清理文件路径以防止目录遍历
  • 谨慎处理二进制数据
  • 考虑对资源读取进行速率限制
  • 审计资源访问
  • 在传输中加密敏感数据
  • 验证 MIME 类型