MCP Tools Reference: sheetsmcp.googleapis.com

도구: get_values

스프레드시트에서 값 범위를 반환합니다. REST API의 spreadsheets.values.get에 해당합니다. https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get

다음 샘플에서는 curl을 사용하여 get_values MCP 도구를 호출하는 방법을 보여줍니다.

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_values",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

GetValuesRequest

JSON 표현 
{
  "spreadsheetId": string,
  "range": string
}
필드
spreadsheetId

string

필수 항목입니다. 데이터를 가져올 스프레드시트의 ID입니다.
range

string

필수 항목입니다. 값을 검색할 범위의 A1 표기법 또는 R1C1 표기법입니다.

출력 스키마

스프레드시트 범위 내의 데이터입니다. https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values

ValueRange

JSON 표현 
{
  "range": string,
  "values": [
    array
  ]
}
필드
range

string

A1 표기법으로 값을 포함하는 범위입니다.
values[]

array (ListValue format)

읽은 데이터입니다. 배열의 배열로, 외부 배열은 모든 데이터를 나타내고 각 내부 배열은 행을 나타냅니다. 내부 배열의 각 항목은 하나의 셀에 해당합니다. 빈 후행 행과 열은 포함되지 않습니다.

ListValue

JSON 표현 
{
  "values": [
    value
  ]
}
필드
values[]

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 숫자를 나타냅니다. JSON에서 지원되지 않으므로 NaN, Infinity 또는 -Infinity가 아니어야 합니다. 또한 JSON 형식은 일반적으로 숫자 유형에서 큰 Int64 값을 지원하지 않으므로 이를 나타낼 수 없습니다.
stringValue

string

JSON 문자열을 나타냅니다.
boolValue

boolean

JSON 부울 (true 또는 JSON의 false 리터럴)을 나타냅니다.
structValue

object (Struct format)

JSON 객체를 나타냅니다.
listValue

array (ListValue format)

JSON 배열을 나타냅니다.

구조체

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)

NullValue

JSON null을 나타냅니다.

NullValue은 Value 유형 통합의 null 값을 나타내기 위해 값이 하나만 있는 열거형을 사용하는 센티널입니다.

0 이외의 값이 있는 NullValue 유형의 필드는 잘못된 것으로 간주됩니다. 대부분의 ProtoJSON 직렬 변환기는 정수 값과 관계없이 null_value가 JSON null로 설정된 Value를 내보내므로 0 값으로 왕복됩니다.

열거형
NULL_VALUE null 값입니다.

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ✅