MCP Reference: sheetsmcp.googleapis.com

यह एक एमसीपी सर्वर है, जो Google Sheets के साथ इंटरैक्ट करने के लिए टूल उपलब्ध कराता है.

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर, लार्ज लैंग्वेज मॉडल (एलएलएम) या एआई ऐप्लिकेशन को कॉन्टेक्स्ट, डेटा या सुविधाएं देने वाली बाहरी सेवा के बीच प्रॉक्सी के तौर पर काम करता है. MCP सर्वर, एआई ऐप्लिकेशन को डेटाबेस और वेब सेवाओं जैसे बाहरी सिस्टम से कनेक्ट करते हैं. साथ ही, उनके जवाबों को ऐसे फ़ॉर्मैट में बदलते हैं जिसे एआई ऐप्लिकेशन समझ सके.

MCP टूल

एमसीपी टूल एक फ़ंक्शन या एक्ज़ीक्यूटेबल क्षमता होती है. इसे एमसीपी सर्वर, एलएलएम या एआई ऐप्लिकेशन के लिए उपलब्ध कराता है, ताकि वह असल दुनिया में कोई कार्रवाई कर सके.

टूल

sheetsmcp.googleapis.com एमसीपी सर्वर में ये टूल मौजूद हैं:

MCP टूल
get_values यह फ़ंक्शन, स्प्रेडशीट से वैल्यू की रेंज दिखाता है. यह REST API में spreadsheets.values.get से मेल खाता है: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get
get_spreadsheet यह फ़ंक्शन, दी गई स्प्रेडशीट के लिए स्प्रेडशीट का कॉन्टेंट दिखाता है. यह फ़ंक्शन, दी गई स्प्रेडशीट आईडी के लिए टाइटल, शीट के नाम, ग्रिड प्रॉपर्टी, और अन्य मेटाडेटा दिखाता है. अनुरोध करने पर, यह फ़ंक्शन ग्रिड का पूरा डेटा भी दिखाता है. यह REST API में spreadsheets.get से मेल खाता है: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get
update_spreadsheet

यह स्प्रेडशीट में एक या उससे ज़्यादा अपडेट लागू करता है.

यह REST API में spreadsheets.batchUpdate से मेल खाता है: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

अपडेट की जा सकने वाली जानकारी की सूची यहां दी गई है:

  • updateSpreadsheetProperties: स्प्रेडशीट की प्रॉपर्टी अपडेट करता है.
  • updateSheetProperties: इस फ़ंक्शन का इस्तेमाल करके, किसी शीट की प्रॉपर्टी अपडेट की जाती हैं.
  • updateDimensionProperties: डाइमेंशन की प्रॉपर्टी अपडेट करता है.
  • updateNamedRange: नाम वाली रेंज को अपडेट करता है.
  • repeatCell: यह फ़ंक्शन, किसी रेंज में मौजूद हर सेल में एक ही वैल्यू को दोहराता है.
  • addNamedRange: इससे नाम वाली रेंज जोड़ी जाती है.
  • deleteNamedRange: इससे नाम वाली रेंज मिट जाती है.
  • addSheet: इससे एक नई शीट जुड़ जाती है.
  • deleteSheet: किसी शीट को मिटाता है.
  • autoFill: मौजूदा डेटा के आधार पर, ज़्यादा डेटा अपने-आप भर जाता है.
  • cutPaste: यह सुविधा, डेटा को एक जगह से काटकर दूसरी जगह चिपकाती है.
  • copyPaste: यह फ़ंक्शन, डेटा को एक जगह से कॉपी करके दूसरी जगह पर चिपकाता है.
  • mergeCells: इससे सेल मर्ज हो जाती हैं.
  • unmergeCells: मर्ज की गई सेल को अनमर्ज करता है.
  • updateBorders: यह फ़ंक्शन, सेल की किसी रेंज में मौजूद बॉर्डर को अपडेट करता है.
  • updateCells: एक साथ कई सेल अपडेट करता है.
  • addFilterView: इससे फ़िल्टर व्यू जोड़ा जाता है.
  • appendCells: यह विकल्प चुनने पर, शीट में डेटा वाली आखिरी लाइन के बाद सेल जुड़ जाते हैं.
  • clearBasicFilter: इससे किसी शीट पर मौजूद बुनियादी फ़िल्टर हट जाता है.
  • deleteDimension: किसी शीट में मौजूद पंक्तियों या कॉलम को मिटाता है.
  • deleteEmbeddedObject: यह फ़ंक्शन, किसी शीट में एम्बेड किए गए ऑब्जेक्ट (जैसे, चार्ट, इमेज) को मिटाता है.
  • deleteFilterView: इस फ़ंक्शन का इस्तेमाल करके, किसी शीट से फ़िल्टर व्यू मिटाया जा सकता है.
  • duplicateFilterView: फ़िल्टर व्यू को डुप्लीकेट करता है.
  • duplicateSheet: किसी शीट का डुप्लीकेट बनाता है.
  • findReplace: इस फ़ंक्शन की मदद से, किसी टेक्स्ट को खोजकर उसकी जगह पर दूसरा टेक्स्ट डाला जा सकता है.
  • insertDimension: इस फ़ंक्शन की मदद से, किसी शीट में नई पंक्तियां या कॉलम जोड़े जा सकते हैं.
  • insertRange: इस फ़ंक्शन की मदद से, शीट में नई सेल डाली जाती हैं. साथ ही, मौजूदा सेल को दूसरी जगह ले जाया जाता है.
  • moveDimension: इस फ़ंक्शन की मदद से, किसी शीट में मौजूद लाइनों या कॉलम को दूसरी जगह ले जाया जा सकता है.
  • updateEmbeddedObjectPosition: इससे एम्बेड किए गए ऑब्जेक्ट (जैसे कि चार्ट, इमेज) की पोज़िशन अपडेट होती है.
  • pasteData: इस फ़ंक्शन का इस्तेमाल करके, किसी शीट में डेटा (एचटीएमएल या सीमांकक वाला) चिपकाया जाता है.
  • textToColumns: यह फ़ंक्शन, टेक्स्ट वाले कॉलम को टेक्स्ट वाले कई कॉलम में बदलता है.
  • updateFilterView: फ़िल्टर व्यू की प्रॉपर्टी अपडेट करता है.
  • deleteRange: किसी शीट से सेल की रेंज मिटाता है और बाकी सेल को शिफ़्ट करता है.
  • appendDimension: डाइमेंशन को किसी शीट के आखिर में जोड़ता है.
  • addConditionalFormatRule: इससे शर्त के साथ फ़ॉर्मैटिंग का नया नियम जोड़ा जाता है.
  • updateConditionalFormatRule: इससे शर्त के साथ फ़ॉर्मैटिंग के मौजूदा नियम को अपडेट किया जाता है.
  • deleteConditionalFormatRule: यह फ़ंक्शन, शर्त के साथ फ़ॉर्मैटिंग के मौजूदा नियम को मिटाता है.
  • sortRange: किसी रेंज में मौजूद डेटा को क्रम से लगाता है.
  • setDataValidation: एक या उससे ज़्यादा सेल के लिए, डेटा की पुष्टि करने की सुविधा सेट करता है.
  • setBasicFilter: किसी शीट पर बुनियादी फ़िल्टर सेट करता है.
  • addProtectedRange: सुरक्षित की गई रेंज जोड़ता है.
  • updateProtectedRange: सुरक्षित की गई रेंज को अपडेट करता है.
  • deleteProtectedRange: सुरक्षित की गई रेंज मिटाता है.
  • autoResizeDimensions: यह फ़ंक्शन, डाइमेंशन में मौजूद सेल के कॉन्टेंट के आधार पर, एक या उससे ज़्यादा डाइमेंशन का साइज़ अपने-आप बदल देता है.
  • addChart: इससे चार्ट जोड़ा जाता है.
  • updateChartSpec: इससे चार्ट की खास बातों को अपडेट किया जाता है.
  • updateBanding: बैंड की गई रेंज को अपडेट करता है
  • addBanding: इससे नई बैंडेड रेंज जोड़ी जाती है
  • deleteBanding: इस फ़ंक्शन का इस्तेमाल, बैंड की गई रेंज को हटाने के लिए किया जाता है
  • createDeveloperMetadata: नया डेवलपर मेटाडेटा बनाता है
  • updateDeveloperMetadata: यह मौजूदा डेवलपर मेटाडेटा एंट्री को अपडेट करता है
  • deleteDeveloperMetadata: डेवलपर मेटाडेटा मिटाता है
  • randomizeRange: यह फ़ंक्शन, किसी रेंज में मौजूद लाइनों के क्रम को बदल देता है.
  • addDimensionGroup: इससे तय की गई रेंज के हिसाब से ग्रुप बनता है.
  • deleteDimensionGroup: इस फ़ंक्शन का इस्तेमाल, तय की गई रेंज में मौजूद ग्रुप को मिटाने के लिए किया जाता है.
  • updateDimensionGroup: इससे चुने गए ग्रुप का स्टेटस अपडेट होता है.
  • trimWhitespace: यह फ़ंक्शन, सेल में मौजूद ग़ैर-ज़रूरी व्हाइटस्पेस (जैसे कि स्पेस, टैब या नई लाइनें) को हटाता है.
  • deleteDuplicates: यह फ़ंक्शन, सेल की किसी रेंज के चुने गए कॉलम में मौजूद डुप्लीकेट वैल्यू वाली पंक्तियों को हटाता है.
  • updateEmbeddedObjectBorder: इससे एम्बेड किए गए ऑब्जेक्ट के बॉर्डर को अपडेट किया जाता है.
  • addSlicer: स्लाइसर जोड़ता है.
  • updateSlicerSpec: स्लाइसर की खास जानकारी अपडेट करता है.
  • addDataSource: इससे डेटा सोर्स जोड़ा जाता है.
  • updateDataSource: इससे डेटा सोर्स अपडेट होता है.
  • deleteDataSource: इससे डेटा सोर्स मिट जाता है.
  • refreshDataSource: इससे एक या एक से ज़्यादा डेटा सोर्स और उनसे जुड़े dbobject रीफ़्रेश होते हैं.
  • cancelDataSourceRefresh: इससे एक या एक से ज़्यादा डेटा सोर्स और उनसे जुड़े dbobject के रीफ़्रेश होने की प्रोसेस रद्द हो जाती है.
  • addTable: इससे कोई टेबल जोड़ी जाती है.
  • updateTable: इससे टेबल अपडेट की जाती है.
  • deleteTable: टेबल मिटाने का अनुरोध.
update_values यह फ़ंक्शन, स्प्रेडशीट की किसी रेंज में वैल्यू सेट करता है. यह REST API में spreadsheets.values.update से मेल खाता है: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
update_formulas यह फ़ंक्शन, स्प्रेडशीट की किसी रेंज में फ़ॉर्मूले सेट करता है. यह REST API में spreadsheets.values.update से मेल खाता है: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
insert_dimension यह फ़ंक्शन, किसी शीट में किसी इंडेक्स पर पंक्तियां या कॉलम जोड़ता है. यह spreadsheets.batchUpdate REST API में InsertDimensionRequest से मेल खाता है: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

MCP टूल की खास जानकारी पाना

किसी एमसीपी सर्वर में मौजूद सभी टूल के लिए, एमसीपी टूल की खास बातें पाने के लिए, tools/list तरीके का इस्तेमाल करें. इस उदाहरण में, curl का इस्तेमाल करके, MCP सर्वर में फ़िलहाल उपलब्ध सभी टूल और उनकी खास बातों को लिस्ट करने का तरीका बताया गया है.

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
}'