MCP Reference: sheetsmcp.googleapis.com

هذا خادم MCP يوفّر أدوات للتفاعل مع "جداول بيانات Google".

يعمل خادم بروتوكول سياق النموذج (MCP) كوكيل بين خدمة خارجية توفّر السياق أو البيانات أو الإمكانات لنموذج لغوي كبير (LLM) أو تطبيق ذكاء اصطناعي. تربط خوادم MCP تطبيقات الذكاء الاصطناعي بأنظمة خارجية، مثل قواعد البيانات وخدمات الويب، وتحوّل ردودها إلى تنسيق يمكن لتطبيق الذكاء الاصطناعي فهمه.

أدوات MCP

أداة MCP هي دالة أو إمكانية قابلة للتنفيذ يعرضها خادم MCP لنموذج لغوي كبير أو تطبيق ذكاء اصطناعي لتنفيذ إجراء في العالم الحقيقي.

الأدوات

يحتوي خادم MCP على sheetsmcp.googleapis.com على الأدوات التالية:

أدوات MCP
get_values لعرض نطاق من القيم من جدول بيانات يتطابق هذا مع spreadsheets.values.get في واجهة برمجة تطبيقات REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get
get_spreadsheet لعرض محتوى جدول البيانات المحدّد يعرض هذا الطلب العناوين وأسماء أوراق البيانات وخصائص الشبكة والبيانات الوصفية الأخرى لرقم تعريف جدول البيانات المحدّد. يعرض أيضًا بيانات الشبكة الكاملة إذا طُلب ذلك. يتطابق هذا مع spreadsheets.get في واجهة برمجة تطبيقات REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get
update_spreadsheet

لتطبيق تعديل واحد أو أكثر على جدول البيانات

يتطابق هذا مع spreadsheets.batchUpdate في واجهة برمجة تطبيقات REST: 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: لإعادة تحميل مصدر بيانات واحد أو أكثر والكائنات المرتبطة به
  • cancelDataSourceRefresh: لإلغاء عمليات إعادة تحميل مصدر بيانات واحد أو أكثر والكائنات المرتبطة به
  • addTable: لإضافة جدول
  • updateTable: لتعديل جدول
  • deleteTable: لطلب حذف جدول
update_values لضبط القيم في نطاق من جدول بيانات يتطابق هذا مع spreadsheets.values.update في واجهة برمجة تطبيقات REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
update_formulas لضبط الصيغ في نطاق من جدول بيانات يتطابق هذا مع spreadsheets.values.update في واجهة برمجة تطبيقات REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
insert_dimension لإدراج صفوف أو أعمدة في ورقة عند فهرس معيّن يتطابق هذا مع InsertDimensionRequest في واجهة برمجة تطبيقات REST spreadsheets.batchUpdate: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

الحصول على مواصفات أداة MCP

للحصول على مواصفات أداة MCP لجميع الأدوات في خادم 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
}'