MCP Tools Reference: sheetsmcp.googleapis.com

Narzędzie: get_spreadsheet

Zwraca zawartość arkusza kalkulacyjnego o podanym identyfikatorze. Zwraca tytuły, nazwy arkuszy, właściwości siatki i inne metadane arkusza kalkulacyjnego o podanym identyfikatorze. Na żądanie zwraca też pełne dane siatki. Odpowiada metodzie spreadsheets.get w interfejsie REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get

Poniższy przykład pokazuje, jak użyć narzędzia curl do wywołania narzędzia MCP get_spreadsheet.

Żądanie Curl 
curl --location 'https://sheetsmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_spreadsheet",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat wejściowy

GetContentRequest

Zapis JSON 
{
  "spreadsheetId": string,
  "includeGridData": boolean
}
Pola
spreadsheetId

string

Wymagane. Identyfikator arkusza kalkulacyjnego, o który chcesz poprosić.
includeGridData

boolean

Wartość true, jeśli mają zostać zwrócone dane siatki.

Schemat wyjściowy

Reprezentuje obiekt JSON.

Nieuporządkowana mapa klucz-wartość, która ma dokładnie odzwierciedlać semantykę obiektu JSON. Umożliwia to analizowanie dowolnego ładunku JSON jako pola wiadomości w formacie ProtoJSON.

Jest to zgodne z wytycznymi RFC 8259 dotyczącymi interoperacyjnego formatu JSON. Ten typ nie może reprezentować dużych wartości Int64 ani liczb NaN/Infinity, ponieważ format JSON nie obsługuje tych wartości w swoim typie liczbowym.

Jeśli nie zamierzasz analizować dowolnego formatu JSON w wiadomości, zamiast tego typu użyj niestandardowej wiadomości z typem.

Struct

Zapis JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Pola
fields

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

Nieuporządkowana mapa wartości o typie dynamicznym.

Obiekt zawierający listę "key": value par. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Zapis JSON 
{
  "key": string,
  "value": value
}
Pola
key

string
value

value (Value format)

Value

Zapis JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Pola
Pole zbiorcze kind. Rodzaj wartości. kind może mieć tylko jedną z tych wartości:
nullValue

null

Reprezentuje wartość JSON null.
numberValue

number

Reprezentuje liczbę JSON. Nie może to być NaN, Infinity ani -Infinity, ponieważ te wartości nie są obsługiwane w formacie JSON. Nie może też reprezentować dużych wartości Int64, ponieważ format JSON nie obsługuje ich w swoim typie liczbowym.
stringValue

string

Reprezentuje ciąg znaków JSON.
boolValue

boolean

Reprezentuje wartość logiczną JSON (true lub false w formacie JSON).
structValue

object (Struct format)

Reprezentuje obiekt JSON.
listValue

array (ListValue format)

Reprezentuje tablicę JSON.

ListValue

Zapis JSON 
{
  "values": [
    value
  ]
}
Pola
values[]

value (Value format)

Pole powtarzane wartości o typie dynamicznym.

NullValue

Reprezentuje wartość JSON null.

NullValue to wartość strażnicza, która używa wyliczenia z tylko jedną wartością do reprezentowania wartości null dla typu zbiorczego Value.

Pole typu NullValue z dowolną wartością inną niż 0 jest uważane za nieprawidłowe. Większość serializatorów ProtoJSON będzie emitować Value z ustawioną wartością null_value jako JSON null niezależnie od wartości całkowitej, a więc będzie zaokrąglać do wartości 0.

Wartości w polu enum
NULL_VALUE Wartość null.

Adnotacje narzędzi

Wskazówka dotycząca działań destrukcyjnych: ❌ | Wskazówka dotycząca idempotentności: ✅ | Wskazówka dotycząca tylko do odczytu: ✅ | Wskazówka dotycząca otwartego świata: ✅