MCP Reference: sheetsmcp.googleapis.com

Jest to serwer MCP, który udostępnia narzędzia do interakcji z Arkuszami Google.

Serwer Model Context Protocol (MCP) działa jako serwer proxy między usługą zewnętrzną, która udostępnia kontekst, dane lub możliwości dużemu modelowi językowemu (LLM) lub aplikacji AI. Serwery MCP łączą aplikacje AI z systemami zewnętrznymi, takimi jak bazy danych i usługi internetowe, tłumacząc ich odpowiedzi na format zrozumiały dla aplikacji AI.

Narzędzia MCP

Narzędzie MCP to funkcja lub możliwość wykonywania, którą serwer MCP udostępnia LLM lub aplikacji AI w celu wykonania działania w świecie rzeczywistym.

Narzędzia

Serwer MCP sheetsmcp.googleapis.com ma te narzędzia:

Narzędzia MCP
get_values Zwraca zakres wartości z arkusza kalkulacyjnego. Odpowiada metodzie spreadsheets.values.get w interfejsie REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get
get_spreadsheet Zwraca zawartość arkusza kalkulacyjnego dla danego arkusza. Zwraca tytuły, nazwy arkuszy, właściwości siatki i inne metadane dla danego identyfikatora arkusza kalkulacyjnego. 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
update_spreadsheet

Stosuje do arkusza kalkulacyjnego co najmniej 1 aktualizację.

Odpowiada metodzie spreadsheets.batchUpdate w interfejsie REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

Lista możliwych aktualizacji:

  • updateSpreadsheetProperties: aktualizuje właściwości arkusza kalkulacyjnego.
  • updateSheetProperties: aktualizuje właściwości arkusza.
  • updateDimensionProperties: aktualizuje właściwości wymiarów.
  • updateNamedRange: aktualizuje nazwany zakres.
  • repeatCell: powtarza pojedynczą komórkę w zakresie.
  • addNamedRange: dodaje nazwany zakres.
  • deleteNamedRange: usuwa zakres nazwany.
  • addSheet: dodaje arkusz.
  • deleteSheet: usuwa arkusz.
  • autoFill: automatycznie wypełnia więcej danych na podstawie istniejących danych.
  • cutPaste: wycina dane z jednego obszaru i wkleja je w innym.
  • copyPaste: kopiuje dane z jednego obszaru i wkleja je w innym.
  • mergeCells: scala komórki.
  • unmergeCells: rozdziela scalone komórki.
  • updateBorders: aktualizuje obramowania w zakresie komórek.
  • updateCells: aktualizuje wiele komórek naraz.
  • addFilterView: dodaje widok przefiltrowany.
  • appendCells: dołącza komórki po ostatnim wierszu z danymi w arkuszu.
  • clearBasicFilter: czyści podstawowy filtr w arkuszu.
  • deleteDimension: usuwa wiersze lub kolumny w arkuszu.
  • deleteEmbeddedObject: usuwa w arkuszu obiekt osadzony (np.wykres, obraz).
  • deleteFilterView: usuwa z arkusza widok przefiltrowany.
  • duplicateFilterView: duplikuje widok przefiltrowany.
  • duplicateSheet: duplikuje arkusz.
  • findReplace: znajduje i zastępuje wystąpienia tekstu innym tekstem.
  • insertDimension: wstawia w arkuszu nowe wiersze lub kolumny.
  • insertRange: wstawia w arkuszu nowe komórki, przesuwając istniejące komórki.
  • moveDimension: przenosi wiersze lub kolumny w inne miejsce w arkuszu.
  • updateEmbeddedObjectPosition: aktualizuje położenie obiektu osadzonego (np. wykresu, obrazu).
  • pasteData: wkleja dane (HTML lub rozdzielane) do arkusza.
  • textToColumns: przekształca kolumnę tekstu w wiele kolumn tekstu.
  • updateFilterView: aktualizuje właściwości widoku przefiltrowanego.
  • deleteRange: usuwa z arkusza zakres komórek, przesuwając pozostałe komórki.
  • appendDimension: dołącza wymiary na końcu arkusza.
  • addConditionalFormatRule: dodaje nową regułę formatowania warunkowego.
  • updateConditionalFormatRule: aktualizuje istniejącą regułę formatowania warunkowego.
  • deleteConditionalFormatRule: usuwa istniejącą regułę formatowania warunkowego.
  • sortRange: sortuje dane w zakresie.
  • setDataValidation: ustawia weryfikację danych w co najmniej 1 komórce.
  • setBasicFilter: ustawia podstawowy filtr w arkuszu.
  • addProtectedRange: dodaje zakres chroniony.
  • updateProtectedRange: aktualizuje zakres chroniony.
  • deleteProtectedRange: usuwa zakres chroniony.
  • autoResizeDimensions: automatycznie zmienia rozmiar co najmniej 1 wymiaru na podstawie zawartości komórek w tym wymiarze.
  • addChart: dodaje wykres.
  • updateChartSpec: aktualizuje specyfikacje wykresu.
  • updateBanding: aktualizuje zakres z pasami
  • addBanding: dodaje nowy zakres z pasami
  • deleteBanding: usuwa zakres z pasami
  • createDeveloperMetadata: tworzy nowe metadane dewelopera
  • updateDeveloperMetadata: aktualizuje istniejący wpis metadanych dewelopera
  • deleteDeveloperMetadata: usuwa metadane dewelopera
  • randomizeRange: losowo zmienia kolejność wierszy w zakresie.
  • addDimensionGroup: tworzy grupę w określonym zakresie.
  • deleteDimensionGroup: usuwa grupę w określonym zakresie.
  • updateDimensionGroup: aktualizuje stan określonej grupy.
  • trimWhitespace: usuwa z komórek białe znaki (takie jak spacje, tabulatory lub nowe wiersze).
  • deleteDuplicates: usuwa wiersze zawierające zduplikowane wartości w określonych kolumnach zakresu komórek.
  • updateEmbeddedObjectBorder: aktualizuje obramowanie obiektu osadzonego.
  • addSlicer: dodaje fragmentator.
  • updateSlicerSpec: aktualizuje specyfikacje fragmentatora.
  • addDataSource: dodaje źródło danych.
  • updateDataSource: aktualizuje źródło danych.
  • deleteDataSource: usuwa źródło danych.
  • refreshDataSource: odświeża co najmniej 1 źródło danych i powiązane obiekty bazy danych.
  • cancelDataSourceRefresh: anuluje odświeżanie co najmniej 1 źródła danych i powiązanych obiektów bazy danych.
  • addTable: dodaje tabelę.
  • updateTable: aktualizuje tabelę.
  • deleteTable: prośba o usunięcie tabeli.
update_values Ustawia wartości w zakresie arkusza kalkulacyjnego. Odpowiada metodzie spreadsheets.values.update w interfejsie REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
update_formulas Ustawia formuły w zakresie arkusza kalkulacyjnego. Odpowiada metodzie spreadsheets.values.update w interfejsie REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
insert_dimension Wstawia w arkuszu wiersze lub kolumny w określonym indeksie. Odpowiada InsertDimensionRequest w interfejsie REST API spreadsheets.batchUpdate: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

Pobieranie specyfikacji narzędzi MCP

Aby uzyskać specyfikacje narzędzi MCP dla wszystkich narzędzi na serwerze MCP, użyj metody tools/list. Poniższy przykład pokazuje, jak za pomocą curl wyświetlić listę wszystkich narzędzi i ich specyfikacji dostępnych obecnie na serwerze MCP.

Żądanie Curl 
curl --location 'https://sheetsmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'