MCP Reference: sheetsmcp.googleapis.com

זהו שרת MCP שמספק כלים לאינטראקציה עם Google Sheets.

שרת Model Context Protocol‏ (MCP) פועל כשרת proxy בין שירות חיצוני שמספק הקשר, נתונים או יכולות למודל שפה גדול (LLM) או לאפליקציית AI. שרתי MCP מחברים אפליקציות AI למערכות חיצוניות כמו מסדי נתונים ושירותי אינטרנט, ומתרגמים את התשובות שלהם לפורמט שאפליקציית ה-AI יכולה להבין.

כלי MCP

כלי MCP הוא פונקציה או יכולת הפעלה ששרת MCP חושף למודל שפה גדול (LLM) או לאפליקציית AI כדי לבצע פעולה בעולם האמיתי.

כלים

לשרת ה-MCP‏ sheetsmcp.googleapis.com יש את הכלים הבאים:

כלי MCP
get_values הפונקציה מחזירה טווח של ערכים מגיליון אלקטרוני. מקביל ל-spreadsheets.values.get ב-API בארכיטקטורת REST: ‏ https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get
get_spreadsheet הפונקציה מחזירה את התוכן של הגיליון האלקטרוני שצוין. הפונקציה מחזירה את הכותרות, שמות הגיליונות, מאפייני הרשת ומטא-נתונים אחרים של הגיליון האלקטרוני שצוין. מחזירה גם נתונים מלאים של הרשת אם מתבקש. מקביל ל-spreadsheets.get ב-API בארכיטקטורת REST: ‏ https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get
update_spreadsheet

הוספת עדכון אחד או יותר לגיליון האלקטרוני.

מקביל ל-spreadsheets.batchUpdate ב-API בארכיטקטורת 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 ב-API בארכיטקטורת REST: ‏ https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
update_formulas הגדרת נוסחאות בטווח של גיליון אלקטרוני. מקביל ל-spreadsheets.values.update ב-API בארכיטקטורת REST: ‏ https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
insert_dimension הפונקציה מוסיפה שורות או עמודות בגיליון באינדקס מסוים. תואם ל-InsertDimensionRequest ב-API בארכיטקטורת 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
}'