MCP Reference: sheetsmcp.googleapis.com

Bu, Google E-Tablolar ile etkileşim kurmak için araçlar sağlayan bir MCP sunucusudur.

Model Context Protocol (MCP) sunucusu, Büyük Dil Modeli'ne (LLM) veya yapay zeka uygulamasına bağlam, veri ya da özellikler sağlayan harici bir hizmet ile bu hizmeti kullanan uygulama arasında proxy görevi görür. MCP sunucuları, yapay zeka uygulamalarını veritabanları ve web hizmetleri gibi harici sistemlere bağlar ve yanıtlarını yapay zeka uygulamasının anlayabileceği bir biçime çevirir.

MCP Araçları

MCP aracı, bir MCP sunucusunun gerçek dünyada işlem yapmak için bir LLM'ye veya yapay zeka uygulamasına sunduğu bir işlev ya da yürütülebilir özelliktir.

Araçlar

sheetsmcp.googleapis.com MCP sunucusunda aşağıdaki araçlar bulunur:

MCP Araçları
get_values Bir e-tablodan değer aralığı döndürür. REST API'deki spreadsheets.values.get ile eşleşir: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get
get_spreadsheet Belirtilen e-tablonun e-tablo içeriğini döndürür. Belirtilen e-tablo kimliği için başlıkları, sayfa adlarını, ızgara özelliklerini ve diğer meta verileri döndürür. İstenirse tam ızgara verilerini de döndürür. REST API'deki spreadsheets.get'e karşılık gelir: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get
update_spreadsheet

E-tabloda bir veya daha fazla güncelleme uygular.

REST API'deki spreadsheets.batchUpdate'e karşılık gelir: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

Olası güncellemelerin listesi:

  • updateSpreadsheetProperties: E-tablonun özelliklerini günceller.
  • updateSheetProperties: Bir sayfanın özelliklerini günceller.
  • updateDimensionProperties: Boyutların özelliklerini günceller.
  • updateNamedRange: Adlandırılmış bir aralığı günceller.
  • repeatCell: Tek bir hücreyi bir aralıkta tekrarlar.
  • addNamedRange: Adlandırılmış bir aralık ekler.
  • deleteNamedRange: Adlandırılmış bir aralığı siler.
  • addSheet: Sayfa ekler.
  • deleteSheet: Sayfayı siler.
  • autoFill: Mevcut verilere göre daha fazla veriyi otomatik olarak doldurur.
  • cutPaste: Verileri bir alandan kesip başka bir alana yapıştırır.
  • copyPaste: Verileri bir alandan kopyalayıp başka bir alana yapıştırır.
  • mergeCells: Hücreleri birleştirir.
  • unmergeCells: Birleştirilen hücreleri ayırır.
  • updateBorders: Hücre aralığındaki kenarlıkları günceller.
  • updateCells: Birçok hücreyi aynı anda günceller.
  • addFilterView: Filtre görünümü ekler.
  • appendCells: Bir sayfada veri içeren son satırdan sonraki hücreleri ekler.
  • clearBasicFilter: Bir sayfadaki temel filtreyi temizler.
  • deleteDimension: Bir sayfadaki satırları veya sütunları siler.
  • deleteEmbeddedObject: Bir sayfadaki yerleştirilmiş nesneyi (ör.grafik, resim) siler.
  • deleteFilterView: Bir sayfadaki filtre görünümünü siler.
  • duplicateFilterView: Filtre görünümünü yineler.
  • duplicateSheet: Sayfayı kopyalar.
  • findReplace: Bazı metinlerin geçtiği yerleri bulup başka metinlerle değiştirir.
  • insertDimension: Bir sayfaya yeni satırlar veya sütunlar ekler.
  • insertRange: Mevcut hücreleri kaydırarak bir sayfaya yeni hücreler ekler.
  • moveDimension: Satırları veya sütunları bir sayfada başka bir konuma taşır.
  • updateEmbeddedObjectPosition: Yerleştirilmiş bir nesnenin (ör. grafik, resim) konumunu günceller.
  • pasteData: Verileri (HTML veya sınırlanmış) bir sayfaya yapıştırır.
  • textToColumns: Bir metin sütununu birçok metin sütununa dönüştürür.
  • updateFilterView: Filtre görünümünün özelliklerini günceller.
  • deleteRange: Bir sayfadaki hücre aralığını siler ve kalan hücreleri kaydırır.
  • appendDimension: Bir sayfanın sonuna boyutlar ekler.
  • addConditionalFormatRule: Yeni bir koşullu biçim kuralı ekler.
  • updateConditionalFormatRule: Mevcut bir koşullu biçim kuralını günceller.
  • deleteConditionalFormatRule: Mevcut bir koşullu biçimlendirme kuralını siler.
  • sortRange: Bir aralıktaki verileri sıralar.
  • setDataValidation: Bir veya daha fazla hücre için veri doğrulamayı ayarlar.
  • setBasicFilter: Bir sayfada temel filtreyi ayarlar.
  • addProtectedRange: Korumalı aralık ekler.
  • updateProtectedRange: Korumalı bir aralığı günceller.
  • deleteProtectedRange: Korumalı bir aralığı siler.
  • autoResizeDimensions: Bir veya daha fazla boyutu, o boyuttaki hücrelerin içeriğine göre otomatik olarak yeniden boyutlandırır.
  • addChart: Grafik ekler.
  • updateChartSpec: Grafiğin özelliklerini günceller.
  • updateBanding: Bantlı bir aralığı günceller
  • addBanding: Yeni bir bantlı aralık ekler
  • deleteBanding: Bantlı bir aralığı kaldırır.
  • createDeveloperMetadata: Yeni geliştirici meta verileri oluşturur.
  • updateDeveloperMetadata: Mevcut bir geliştirici meta verileri girişini günceller.
  • deleteDeveloperMetadata: Geliştirici meta verilerini siler.
  • randomizeRange: Bir aralıktaki satırların sırasını rastgele hale getirir.
  • addDimensionGroup: Belirtilen aralıkta bir grup oluşturur.
  • deleteDimensionGroup: Belirtilen aralıktaki bir grubu siler.
  • updateDimensionGroup: Belirtilen grubun durumunu günceller.
  • trimWhitespace: Hücrelerdeki boşlukları (ör. boşluk, sekme veya yeni satır) kaldırır.
  • deleteDuplicates: Bir hücre aralığının belirtilen sütunlarında yinelenen değerler içeren satırları kaldırır.
  • updateEmbeddedObjectBorder: Yerleştirilmiş bir nesnenin kenarlığını günceller.
  • addSlicer: Dilimleyici ekler.
  • updateSlicerSpec: Dilimleyicinin özelliklerini günceller.
  • addDataSource: Veri kaynağı ekler.
  • updateDataSource: Veri kaynağını günceller.
  • deleteDataSource: Veri kaynağını siler.
  • refreshDataSource: Bir veya daha fazla veri kaynağını ve ilişkili dbobject'leri yeniler.
  • cancelDataSourceRefresh: Bir veya daha fazla veri kaynağının ve ilişkili dbobject'lerin yenilenmesini iptal eder.
  • addTable: Tablo ekler.
  • updateTable: Tabloyu günceller.
  • deleteTable: Tablo silme isteği.
update_values Bir e-tablonun aralığındaki değerleri ayarlar. REST API'deki spreadsheets.values.update ile eşleşir: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
update_formulas E-tablonun bir aralığında formüller ayarlar. REST API'deki spreadsheets.values.update ile eşleşir: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
insert_dimension Bir sayfaya belirli bir dizinde satır veya sütun ekler. Corresponds to an InsertDimensionRequest in the spreadsheets.batchUpdate REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

MCP aracı özelliklerini edinme

Bir MCP sunucusundaki tüm araçlar için MCP aracı özelliklerini almak üzere tools/list yöntemini kullanın. Aşağıdaki örnekte, MCP sunucusunda şu anda kullanılabilen tüm araçları ve özelliklerini listelemek için curl komutunun nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
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
}'