资源

模型上下文协议（MCP）为服务器提供了一种向客户端暴露资源的标准化方式。资源允许服务器共享为语言模型提供上下文的数据，如文件、数据库架构或特定应用程序的信息。每个资源都由一个URI唯一标识。

用户交互模型

MCP中的资源设计为应用程序驱动，由宿主应用程序根据其需求决定如何整合上下文。

例如，应用程序可以：

通过UI元素（如树形视图或列表视图）显式暴露资源供选择
允许用户搜索和过滤可用资源
基于启发式规则或AI模型的选择实现自动上下文包含

资源上下文选择器示例

然而，具体实现可以根据其需求通过任何界面模式来暴露资源—协议本身不强制要求任何特定的用户交互模型。

功能特性

支持资源的服务器必须声明resources功能：

{
  "capabilities": {
    "resources": {
      "subscribe": true,
      "listChanged": true
    }
  }
}

该功能支持两个可选特性：

subscribe：客户端是否可以订阅单个资源的变更通知。
listChanged：服务器是否会在可用资源列表发生变化时发出通知。

subscribe和listChanged都是可选的—服务器可以不支持、支持其中之一或同时支持两者：

{
  "capabilities": {
    "resources": {} // 两个特性都不支持
  }
}

{
  "capabilities": {
    "resources": {
      "subscribe": true // 仅支持订阅
    }
  }
}

{
  "capabilities": {
    "resources": {
      "listChanged": true // 仅支持列表变更通知
    }
  }
}

协议消息

列出资源

客户端发送resources/list请求来发现可用资源。此操作支持分页。

请求：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/list",
  "params": {
    "cursor": "可选的游标值"
  }
}

响应：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "resources": [
      {
        "uri": "file:///project/src/main.rs",
        "name": "main.rs",
        "description": "主应用程序入口点",
        "mimeType": "text/x-rust"
      }
    ],
    "nextCursor": "下一页游标"
  }
}

读取资源

客户端发送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",
        "mimeType": "text/x-rust",
        "text": "fn main() {\n    println!(\"Hello world!\");\n}"
      }
    ]
  }
}

资源模板

资源模板允许服务器使用URI模板暴露参数化资源。参数可以通过补全API自动完成。

请求：

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "resources/templates/list"
}

响应：

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "resourceTemplates": [
      {
        "uriTemplate": "file:///{path}",
        "name": "项目文件",
        "description": "访问项目目录中的文件",
        "mimeType": "application/octet-stream"
      }
    ]
  }
}

列表变更通知

当可用资源列表发生变化时，声明了listChanged功能的服务器应该发送通知：

{
  "jsonrpc": "2.0",
  "method": "notifications/resources/list_changed"
}

消息流

数据类型

资源

资源定义包括：

uri：资源的唯一标识符
name：人类可读的名称
description：可选的描述
mimeType：可选的MIME类型

资源内容

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

文本内容

{
  "uri": "file:///example.txt",
  "mimeType": "text/plain",
  "text": "资源内容"
}

二进制内容

{
  "uri": "file:///example.png",
  "mimeType": "image/png",
  "blob": "base64编码的数据"
}

常用URI方案

协议定义了几个标准URI方案。这个列表并非详尽无遗—实现始终可以自由使用额外的自定义URI方案。

https://

用于表示在网络上可用的资源。

服务器应该仅在客户端能够直接从网络获取和加载资源时使用此方案—也就是说，客户端不需要通过MCP服务器读取资源。

对于其他用例，服务器应该优先使用另一个URI方案，或定义一个自定义方案，即使服务器本身将通过互联网下载资源内容。

file://

用于标识行为类似文件系统的资源。但是，这些资源不需要映射到实际的物理文件系统。

MCP服务器可以使用XDG MIME类型（如inode/directory）来标识file://资源，以表示没有标准MIME类型的非常规文件（如目录）。

git://

Git版本控制集成。

错误处理

服务器应该为常见失败情况返回标准JSON-RPC错误：

资源未找到：-32002
内部错误：-32603

错误示例：

{
  "jsonrpc": "2.0",
  "id": 5,
  "error": {
    "code": -32002,
    "message": "资源未找到",
    "data": {
      "uri": "file:///nonexistent.txt"
    }
  }
}

安全考虑

服务器必须验证所有资源URI
应该为敏感资源实现访问控制
二进制数据必须正确编码
应该在操作前检查资源权限

Previous提示词

Next工具