协议修订: 草案
Model Context Protocol (MCP) 提供了一种标准化方式，让服务器能够向客户端暴露资源。资源允许服务器共享为语言模型提供上下文的数据，例如文件、数据库模式或应用特定信息。每个资源都通过一个 URI 被唯一标识。

​
用户交互模型

MCP中的资源设计为应用驱动，由主机应用程序根据其需要决定如何集成上下文。 例如，应用程序可以：
  • 通过UI元素以树状或列表视图展示资源，以便进行明确选择
  • 允许用户搜索和筛选可用资源
  • 基于启发式方法或AI模型的选择，实现自动上下文包含
Example of resource context picker 然而，实现方案可以根据自己的需求通过任意接口模式暴露资源——协议本身并不强制规定任何特定的用户交互模式。

​
能力

支持资源的服务器必须声明 resources 能力： 
{
  "capabilities": {
    "resources": {
      "subscribe": true,
      "listChanged": true
    }
  }
}
该功能支持两个可选特性：
  • subscribe: 客户端是否可以订阅以接收对个别资源的变更通知。
  • listChanged: 服务器会在可用资源列表发生变化时发出通知。
两个 subscribe 和 listChanged 都是可选的——服务器可以两者都不支持，支持其中之一，或者两者都支持： 
{
  "capabilities": {
    "resources": {} // Neither feature supported
  }
}

{
  "capabilities": {
    "resources": {
      "subscribe": true // Only subscriptions supported
    }
  }
}

{
  "capabilities": {
    "resources": {
      "listChanged": true // Only list change notifications supported
    }
  }
}

​
协议消息

​
列出资源

为发现可用资源，客户端会发送resources/list请求。此操作 支持分页。 请求: 请求内容： 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/list",
  "params": {
    "cursor": "optional-cursor-value"
  }
}
响应： 
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "resources": [
      {
        "uri": "file:///project/src/main.rs",
        "name": "main.rs",
        "title": "Rust Software Application Main File",
        "description": "Primary application entry point",
        "mimeType": "text/x-rust",
        "icons": [
          {
            "src": "https://example.com/rust-file-icon.png",
            "mimeType": "image/png",
            "sizes": "48x48"
          }
        ]
      }
    ],
    "nextCursor": "next-page-cursor"
  }
}

​
读取资源

要获取资源内容，客户端发送一个resources/read请求： 请求： 
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "resources/read",
  "params": {
    "uri": "file:///project/src/main.rs"
  }
}
回复: 
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "contents": [
      {
        "uri": "file:///project/src/main.rs",
        "name": "main.rs",
        "title": "Rust Software Application Main File",
        "mimeType": "text/x-rust",
        "text": "fn main() {\n    println!(\"Hello world!\");\n}"
      }
    ]
  }
}

​
资源模板

资源模板允许服务器使用 URI模板公开参数化资源。参数可以通过 the completion API自动完成。 请求: 
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "resources/templates/list"
}
回复: 
{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "resourceTemplates": [
      {
        "uriTemplate": "file:///{path}",
        "name": "Project Files",
        "title": "📁 Project Files",
        "description": "Access files in the project directory",
        "mimeType": "application/octet-stream"
      }
    ]
  }
}

​
列表变更通知

当可用资源列表变更时，声明了 listChanged 功能的服务器应当发送通知： 
{
  "jsonrpc": "2.0",
  "method": "notifications/resources/list_changed"
}

​
订阅管理

协议支持可选地订阅资源变更。客户端可以订阅特定资源，并在它们发生变化时接收通知： 订阅请求： 
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "resources/subscribe",
  "params": {
    "uri": "file:///project/src/main.rs"
  }
}
更新通知： 
{
  "jsonrpc": "2.0",
  "method": "notifications/resources/updated",
  "params": {
    "uri": "file:///project/src/main.rs",
    "title": "Rust Software Application Main File"
  }
}

​
消息流

​
数据类型

​
资源

资源定义包括：
  • uri: 资源的唯一标识符
  • name: 资源的名称。
  • title: 可选的人类可读展示名称，用于标识资源。
  • description: 可选的描述
  • mimeType: 可选的 MIME 类型
  • size: 可选大小，单位为字节

​
资源内容

资源可以包含文本或二进制数据：

​
文本内容

{
  "uri": "file:///example.txt",
  "name": "example.txt",
  "title": "Example Text File",
  "mimeType": "text/plain",
  "text": "Resource content"
}

​
二进制内容

{
  "uri": "file:///example.png",
  "name": "example.png",
  "title": "Example Image",
  "mimeType": "image/png",
  "blob": "base64-encoded-data"
}

​
注释

资源、资源模板和内容区块支持可选注解，这些注解向客户端提供关于如何使用或显示资源的提示：
  • audience: 一个数组，指示此资源的预期受众群体。有效值为 "user" 和 "assistant"。例如，["user", "assistant"] 表示对双方都有用的内容。
  • priority: 一个从0.0到1.0的数字，表示该资源的重要性。值为1表示"最重要"（实际上是必需的），而0表示"最不重要"（完全可选）。
  • lastModified: 一个ISO 8601格式的时间戳，表示资源的最后修改时间（例如，"2025-01-12T15:00:58Z"）。
示例资源及注释： 
{
  "uri": "file:///project/README.md",
  "name": "README.md",
  "title": "Project Documentation",
  "mimeType": "text/markdown",
  "annotations": {
    "audience": ["user"],
    "priority": 0.8,
    "lastModified": "2025-01-12T15:00:58Z"
  }
}
客户端可以使用这些注解来：
  • 基于目标受众筛选资源
  • 优先确定哪些资源应包含在上下文环境中
  • 显示修改时间或按最近性排序

​
通用URI方案

该协议定义了若干标准URI方案。此列表并非完整无遗——实现时始终可以自由使用额外的自定义URI方案。

​
https://

用于表示网络上可用的资源. 服务器 应该 (SHOULD) 仅在客户端能够自行从网络中获取和加载资源时使用此方案——也就是说，不需要通过 MCP 服务器读取该资源。 对于其他用途场景，服务器应当优先使用其他URI方案，或定义一个自定义方案，即使服务器本身将通过互联网下载资源内容。

​
文件://

用于标识行为类似文件系统的资源。但这些资源不需要映射到实际物理文件系统。 MCP servers 可能 使用 XDG MIME 类型（例如 inode/directory）来标识表示非常规文件（如目录）的 file:// 资源，这些文件没有标准的 MIME 类型。

​
git://

Git版本控制集成。

​
自定义URI方案

自定义URI方案必需符合RFC3986标准， 同时需将上述指导原则纳入考量。

​
错误处理

服务器应该 (SHOULD)为标准故障情况返回标准JSON-RPC错误:
  • 资源未找到：-32002
  • 内部错误: -32603
示例错误： 
{
  "jsonrpc": "2.0",
  "id": 5,
  "error": {
    "code": -32002,
    "message": "Resource not found",
    "data": {
      "uri": "file:///nonexistent.txt"
    }
  }
}

​
安全注意事项

  1. 服务器必须验证所有资源URI
  2. 对于敏感资源应该实施访问控制
  3. 二进制数据必须进行正确编码
  4. 在执行操作前，必须检查资源权限