MCP Tools Reference: drivemcp.googleapis.com

כלי: read_file_content

אפשר להשתמש בכלי הזה כדי לאחזר ייצוג בשפה טבעית של קובץ ב-Drive, ואם רוצים, גם של התגובות שלו.

יכול להיות שהתוכן של קבצים גדולים מאוד לא יהיה מלא. הייצוג הטקסטואלי ישתנה עם הזמן, לכן אל תניחו הנחות לגבי הפורמט הספציפי של הטקסט שמוחזר על ידי הכלי הזה. אם יש תמיכה בתגי תגובות, הם ייכללו בתוכן.

סוגי MIME נתמכים:

  • application/vnd.google-apps.document
  • application/vnd.google-apps.presentation
  • application/vnd.google-apps.spreadsheet
  • application/pdf
  • application/msword
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.oasis.opendocument.spreadsheet
  • application/vnd.oasis.opendocument.presentation
  • application/x-vnd.oasis.opendocument.text
  • image/png
  • image/jpeg
  • image/jpg

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

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ read_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": "read_file_content",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

בקשה לקרוא תוכן של קובץ עם תמיכה באחזור תגובות.

ReadFileContentRequest

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

string

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

boolean

האם לכלול תגובות בתשובה. התגובות יופיעו בתוך תוכן הטקסט של הקובץ, עם מיפוי לשרשורי התגובות.

סכימת הפלט

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

ReadFileContentResponse

ייצוג ב-JSON 
{
  "contentAnchoredComments": [
    {
      object (CommentThread)
    }
  ],
  "unanchoredComments": [
    {
      object (CommentThread)
    }
  ],

  "fileContent": string

  "textFormattingNotSupported": boolean
  // End of list of possible types for union field
  // _text_formatting_not_supported.

  "commentsNotSupported": boolean
}
שדות
contentAnchoredComments[]

object (CommentThread)

שרשורי תגובות שאליהם יש הפניה ב-file_content שמוחזר.
unanchoredComments[]

object (CommentThread)

שרשורי תגובות שלא ניתן היה לקשר לתוכן ספציפי בקובץ שהוחזר.

שדה איחוד _file_content.

הערך _file_content יכול להיות רק אחד מהבאים:
fileContent

string

תוכן הקובץ ב-Drive שמוחזר בפורמט טקסט. יכול להיות ריק אם אין תמיכה בעיצוב הטקסט בקובץ. יכול לכלול הפניות לתגובות אם הערך של include_comments הוא true בבקשה.

שדה איחוד _text_formatting_not_supported.

הערך _text_formatting_not_supported יכול להיות רק אחד מהבאים:
textFormattingNotSupported

boolean

האם יש תמיכה בעיצוב טקסט בקובץ הזה. אם הערך הוא true, התוכן של file_content יהיה ריק.

שדה איחוד _comments_not_supported.

הערך _comments_not_supported יכול להיות רק אחד מהבאים:
commentsNotSupported

boolean

האם יש תמיכה בהחזרת הערות בקובץ הזה. המאפיין הזה מופיע רק אם הערך של include_comments הוא TRUE בבקשה, והתגובות לא אפשרי.

CommentThread

ייצוג ב-JSON 
{
  "replies": [
    {
      object (Post)
    }
  ],

  "commentId": string

  "status": enum (Status)

  "headPost": {
    object (Post)
  }
}
שדות
replies[]

object (Post)

התשובות לפוסט הראשון בשרשור התגובות.

שדה איחוד _comment_id.

הערך _comment_id יכול להיות רק אחד מהבאים:
commentId

string

המזהה של שרשור התגובות. זהו אותו מזהה כמו של התגובה הראשונית.

שדה איחוד _status.

הערך _status יכול להיות רק אחד מהבאים:
status

enum (Status)

הסטטוס של שרשור התגובות.

שדה איחוד _head_post.

הערך _head_post יכול להיות רק אחד מהבאים:
headPost

object (Post)

הפוסט הראשון בשרשור התגובות.

פרסום

ייצוג ב-JSON 
{

  "postId": string

  "content": string

  "authorName": string

  "modifiedTime": string
}
שדות

שדה איחוד _post_id.

הערך _post_id יכול להיות רק אחד מהבאים:
postId

string

המזהה של הפוסט.

שדה איחוד _content.

הערך _content יכול להיות רק אחד מהבאים:
content

string

התוכן של הפוסט.

שדה איחוד _author_name.

הערך _author_name יכול להיות רק אחד מהבאים:
authorName

string

השם של מחבר הפוסט.

שדה איחוד _modified_time.

הערך _modified_time יכול להיות רק אחד מהבאים:
modifiedTime

string (Timestamp format)

השעה שבה בוצע השינוי האחרון בפוסט.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

חותמת זמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג את השניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ב-1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-‎253402300799, כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

שברים לא שליליים של שנייה ברזולוציית ננו-שנייה. השדה הזה מייצג את החלק של הננו-שנייה במשך הזמן, ולא מהווה חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שסופרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל.

סטטוס

המאפיין מגדיר את הסטטוס של שרשור התגובות.

טיפוסים בני מנייה (enum)
STATUS_UNSPECIFIED
OPEN
RESOLVED

הערות על כלים

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

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של 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