Resources: ресурсы

описана редакция 2026-07-28, сверено со спецификацией 4 октября 2026

Источник - страница Resources спецификации. В примерах для краткости опущено поле _meta; в настоящем запросе оно обязательно.

Ресурсами управляет приложение. Хост сам решает, как показывать их и когда подставлять в контекст: списком для выбора, поиском или автоматически. Протокол способ не предписывает.

Сервер с ресурсами обязан объявить возможность resources. У неё два необязательных признака.

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/list",
  "params": {}
}

Каждый ресурс в ответе описан полями:

Как и список инструментов, список ресурсов не зависит от соединения, но может зависеть от прав, с которыми пришёл запрос. Запрос поддерживает постраничную выдачу.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "resources/read",
  "params": { "uri": "file:///project/src/main.rs" }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "resultType": "complete",
    "contents": [
      {
        "uri": "file:///project/src/main.rs",
        "mimeType": "text/x-rust",
        "text": "fn main() {\n    println!(\"Hello world!\");\n}"
      }
    ],
    "ttlMs": 60000,
    "cacheScope": "private"
  }
}

Содержимое бывает текстовым (поле text) или двоичным (поле blob, данные в Base64). На один запрос сервер может вернуть несколько элементов, например файлы каталога.

Сервер может ответить и просьбой о дополнительных данных - см. «Многошаговые запросы».

Запрос resources/templates/list возвращает шаблоны по RFC 6570 - адреса с параметрами, например file:///{path}. Клиент подставляет значения и читает получившийся адрес обычным resources/read.

Результаты resources/list, resources/templates/list и resources/read обязаны нести два поля из раздела Caching.

Срок жизни - подсказка, а не гарантия: данные могут измениться раньше. И это не интервал опроса: клиент проверяет свежесть, когда данные ему понадобились.

cacheScope не заменяет разграничение доступа. Сервер обязан проверять права на каждый ресурс сам.

Чтобы следить за ресурсами, клиент открывает поток запросом subscriptions/listen и перечисляет в нём адреса. Отдельных запросов resources/subscribe и resources/unsubscribe в редакции 2026-07-28 нет: поток subscriptions/listen их заменил.

Ресурсы, шаблоны и блоки содержимого могут нести подсказки для клиента.

Схему https:// серверу следует использовать только тогда, когда клиент действительно может получить ресурс напрямую.

До редакции 2026-07-28 для отсутствующего ресурса использовался код -32002. Клиенту следует принимать и его, чтобы работать со старыми серверами.

Пустой список contents для несуществующего ресурса возвращать нельзя: он неотличим от ресурса без содержимого.

• Сервер обязан проверять все адреса ресурсов.
• Сервер обязан очищать пути файлов, чтобы запрос не вышел за пределы разрешённого каталога.
• Двоичные данные обязаны быть корректно закодированы.
• Для чувствительных ресурсов следует разграничивать доступ и проверять права перед операцией.