MCP Tools Reference: drivemcp.googleapis.com

כלי: download_file_content

אפשר להשתמש בכלי הזה כדי להוריד את התוכן של קובץ ב-Drive כמחרוזת בקידוד Base64.

אם הקובץ הוא סוג MIME של צד ראשון ב-Google Drive, השדה exportMimeType נדרש ויקבע את הפורמט של הקובץ שהורד.

אם הקובץ לא נמצא, אפשר לנסות להשתמש בכלים אחרים כמו search_files כדי למצוא את הקובץ שהמשתמש מבקש.

אם המשתמש רוצה ייצוג בשפה טבעית של התוכן שלו ב-Drive, צריך להשתמש בכלי read_file_content (read_file_content צריך להיות קטן יותר וקל יותר לניתוח).

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ download_file_content.

בקשת Curl 
curl --location 'https://drivemcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "download_file_content",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

הגדרת בקשה להורדת תוכן של קובץ.

DownloadFileRequest

ייצוג ב-JSON 
{
  "fileId": string,
  "exportMimeType": string
}
שדות
fileId

string

חובה. המזהה של הקובץ לאחזור.
exportMimeType

string

אופציונלי. עבור קבצים מקוריים של Google, סוג ה-MIME לייצוא הקובץ. אחרת, המערכת מתעלמת מהערך. אם לא מציינים ערך, ברירת המחדל היא text.

סכימת הפלט

התשובה לבקשה להורדת קובץ.

FileContent

ייצוג ב-JSON 
{
  "id": string,
  "title": string,
  "mimeType": string,
  "content": string
}
שדות
id

string

המזהה של הקובץ.
title

string

שם הקובץ.
mimeType

string

סוג ה-MIME של הקובץ.
content

string

התוכן של הקובץ בקידוד base64.

הערות על כלים

רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly