MCP Tools Reference: slidesmcp.googleapis.com

Инструмент: read_presentation

Как прочитать представление презентации Google в формате JSON

Соответствует параметру presentations.get в REST API.

В приведенном ниже фрагменте кода показано, как использовать curl для вызова инструмента read_presentation MCP.

Запрос curl 
curl --location 'https://slidesmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "read_presentation",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Запросить чтение презентации.

ReadPresentationRequest

JSON-представление 
{
  "presentationId": string,
  "fields": [
    string
  ],

  "commentsIncluded": boolean
}
Поля
presentationId

string

Обязательно. Идентификатор презентации, из которой нужно прочитать контент.
fields[]

string

Необязательное поле. Маска поля, указывающая, какое подмножество свойств нужно вернуть. Пути должны точно соответствовать структуре ресурсов JSON REST API Google Презентаций (например, Presentation, Page, PageElement, Shape, Image, Table, Line, Video, TextContent).

ВАЖНЫЕ ПРАВИЛА. Всегда используйте маски целевых полей, а не получайте объекты презентации без масок или общие объекты презентации. – Синтаксис. Поддерживаются точечная нотация и круглые скобки для подвыборки (например, slides.pageElements(objectId,shape.text) или slides.pageElements.objectId,slides.pageElements.shape.text).– Указывайте только нужные поля.

Объединенное поле _comments_included.

Поле _comments_included может иметь одно из следующих значений:
commentsIncluded

boolean

Необязательное поле. Если значение равно true, комментарии будут включены в ответ. По умолчанию комментарии не включаются.

Схема вывода

Ответ, содержащий представление презентации в формате JSON.

ReadPresentationResponse

JSON-представление 
{
  "content": {
    object
  }
}
Поля
content

object (Struct format)

JSON-представление презентации Google.

Структура

JSON-представление 
{
  "fields": {
    string: value,
    ...
  }
}
Поля
fields

map (key: string, value: value (Value format))

Неупорядоченная карта значений с динамической типизацией.

Объект содержит список из нескольких пар ("key": value). Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON-представление 
{
  "key": string,
  "value": value
}
Поля
key

string
value

value (Value format)

Значение

JSON-представление 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Поля
Объединенное поле kind. Тип значения. kind может иметь одно из следующих значений:
nullValue

null

Представляет объект JSON null.
numberValue

number

Представляет число JSON. Не должно быть NaN, Infinity или -Infinity, поскольку эти значения не поддерживаются в JSON. Кроме того, этот формат не подходит для больших значений Int64, поскольку формат JSON обычно не поддерживает их в качестве чисел.
stringValue

string

Представляет строку JSON.
boolValue

boolean

Представляет логическое значение JSON (литерал true или false в JSON).
structValue

object (Struct format)

Представляет объект JSON.
listValue

array (ListValue format)

Представляет собой массив JSON.

ListValue

JSON-представление 
{
  "values": [
    value
  ]
}
Поля
values[]

value (Value format)

Повторяющееся поле со значениями динамического типа.

NullValue

Представляет объект JSON null.

NullValue – это страж, использующий перечисление с одним значением для представления нулевого значения для объединения типов Value.

Поле типа NullValue с любым значением, кроме 0, считается недопустимым. Большинство сериализаторов ProtoJSON будут создавать Value с null_value, заданным как JSON null, независимо от целочисленного значения, и поэтому будут выполнять преобразование в значение 0.

Перечисления
NULL_VALUE Нулевое значение.

Аннотации инструментов

Аннотации инструментов отправляются клиентам MCP, чтобы описать основной риск, связанный с определенным инструментом. Большинство клиентов считают эти подсказки ненадежными, но их можно использовать, чтобы определить, когда пользователю может быть отправлен запрос на подтверждение.

Вместе со строкой заголовка определены следующие логические подсказки:

  • readOnlyHint: если значение равно true, инструмент не изменяет среду. Значение по умолчанию – false.
  • destructiveHint: если задано значение True, инструмент может выполнять деструктивные действия. Если задано значение false, инструмент может выполнять только действия по добавлению. Значение по умолчанию: true.
  • idempotentHint: если задано значение True, повторный вызов инструмента с теми же аргументами не окажет дополнительного влияния на его среду. Значение по умолчанию – false.
  • openWorldHint – если значение равно true, инструмент может взаимодействовать с внешними объектами. Если значение равно false, инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет открытым миром, а инструмент памяти – нет.

Деструктивный подсказка: ❌ | Идемпотентный подсказка: ✅ | Подсказка "Только чтение": ✅ | Подсказка "Открытый мир": ✅

Области авторизации

Требует одной из следующих областей применения OAuth:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/presentations.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations