MCP Reference: sheetsmcp.googleapis.com

این یک سرور MCP است که ابزارهایی برای تعامل با Google Sheets ارائه می‌دهد.

یک سرور پروتکل زمینه مدل (MCP) به عنوان یک پروکسی بین یک سرویس خارجی عمل می‌کند که زمینه، داده‌ها یا قابلیت‌هایی را برای یک مدل زبان بزرگ (LLM) یا برنامه هوش مصنوعی فراهم می‌کند. سرورهای MCP برنامه‌های هوش مصنوعی را به سیستم‌های خارجی مانند پایگاه‌های داده و سرویس‌های وب متصل می‌کنند و پاسخ‌های آنها را به فرمتی که برنامه هوش مصنوعی می‌تواند درک کند، ترجمه می‌کنند.

ابزارهای MCP

یک ابزار MCP یک تابع یا قابلیت اجرایی است که یک سرور MCP آن را در اختیار یک برنامه LLM یا هوش مصنوعی قرار می‌دهد تا عملی را در دنیای واقعی انجام دهد.

ابزارها

سرور MCP sheetsmcp.googleapis.com ابزارهای زیر را دارد:

ابزارهای MCP
get_values طیف وسیعی از مقادیر را از یک صفحه گسترده برمی‌گرداند. مربوط به spreadsheets.values.get در REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get
get_spreadsheet محتوای صفحه‌گسترده را برای صفحه‌گسترده داده شده برمی‌گرداند. عناوین، نام‌های صفحه، ویژگی‌های شبکه و سایر فراداده‌ها را برای شناسه صفحه‌گسترده داده شده برمی‌گرداند. همچنین در صورت درخواست، داده‌های کامل شبکه را برمی‌گرداند. مربوط به spreadsheets.get در REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get
update_spreadsheet

یک یا چند به‌روزرسانی را در صفحه‌گسترده اعمال می‌کند.

مربوط به spreadsheets.batchUpdate در REST API: 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 : داده‌ها (HTML یا جدا شده) را در یک برگه جایگذاری می‌کند.
  • 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 مقادیر را در محدوده‌ای از یک صفحه‌گسترده تنظیم می‌کند. معادل spreadsheets.values.update در REST API است: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
update_formulas فرمول‌ها را در محدوده‌ای از یک صفحه‌گسترده تنظیم می‌کند. معادل spreadsheets.values.update در REST API است: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
insert_dimension ردیف‌ها یا ستون‌ها را در یک صفحه در یک فهرست خاص درج می‌کند. مربوط به یک درخواست درج ابعاد (InsertDimensionRequest) در spreadsheets.batchUpdate REST API است: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

مشخصات ابزار MCP را دریافت کنید

برای دریافت مشخصات ابزار MCP برای همه ابزارهای موجود در یک سرور MCP، از متد tools/list استفاده کنید. مثال زیر نحوه استفاده از curl برای فهرست کردن همه ابزارها و مشخصات آنها که در حال حاضر در سرور MCP موجود هستند را نشان می‌دهد.

درخواست کرل 
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
}'