MCP Tools Reference: drivemcp.googleapis.com

Công cụ: read_file_content

Gọi công cụ này để tìm nạp nội dung biểu thị bằng ngôn ngữ tự nhiên của một tệp trên Drive và tuỳ ý, các bình luận của tệp đó.

Nội dung tệp có thể không đầy đủ đối với các tệp có kích thước rất lớn. Biểu diễn văn bản sẽ thay đổi theo thời gian, vì vậy, đừng giả định về định dạng cụ thể của văn bản do công cụ này trả về. Nếu được hỗ trợ, thẻ bình luận sẽ xuất hiện trong nội dung.

Các loại MIME được hỗ trợ:

  • 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

Nếu không tìm thấy tệp, hãy thử dùng các công cụ khác như search_files để tìm tệp mà người dùng đang yêu cầu bằng cách sử dụng từ khoá.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ MCP read_file_content.

Yêu cầu 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
}'

Giản đồ đầu vào

Yêu cầu đọc nội dung tệp có hỗ trợ tìm nạp bình luận.

ReadFileContentRequest

Biểu diễn dưới dạng JSON 
{
  "fileId": string,
  "includeComments": boolean
}
Trường
fileId

string

Bắt buộc. Mã nhận dạng của tệp cần truy xuất.
includeComments

boolean

Có đưa bình luận vào câu trả lời hay không. Các nhận xét sẽ được chèn vào nội dung văn bản của tệp cùng với một bản đồ đến các chuỗi nhận xét.

Giản đồ đầu ra

Phản hồi để đọc nội dung tệp.

ReadFileContentResponse

Biểu diễn dưới dạng 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
}
Trường
contentAnchoredComments[]

object (CommentThread)

Các chuỗi bình luận được tham chiếu trong file_content được trả về.
unanchoredComments[]

object (CommentThread)

Các chuỗi bình luận không thể được liên kết với nội dung cụ thể trong tệp được trả về.

Trường nhóm _file_content.

_file_content chỉ có thể là một trong những trạng thái sau:
fileContent

string

Nội dung tệp trên Drive được trả về ở định dạng văn bản. Có thể trống nếu tệp không hỗ trợ định dạng văn bản. Có thể bao gồm các tham chiếu đến bình luận nếu include_comments là true trong yêu cầu.

Trường nhóm _text_formatting_not_supported.

_text_formatting_not_supported chỉ có thể là một trong những trạng thái sau:
textFormattingNotSupported

boolean

Liệu tệp này có hỗ trợ định dạng văn bản hay không. Nếu đúng, file_content sẽ trống.

Trường nhóm _comments_not_supported.

_comments_not_supported chỉ có thể là một trong những trạng thái sau:
commentsNotSupported

boolean

Liệu tệp này có hỗ trợ việc trả về bình luận hay không. Chỉ xuất hiện nếu include_comments là true trong yêu cầu và không hỗ trợ bình luận.

CommentThread

Biểu diễn dưới dạng JSON 
{
  "replies": [
    {
      object (Post)
    }
  ],

  "commentId": string

  "status": enum (Status)

  "headPost": {
    object (Post)
  }
}
Trường
replies[]

object (Post)

Các câu trả lời cho bài đăng đầu tiên trong chuỗi bình luận.

Trường nhóm _comment_id.

_comment_id chỉ có thể là một trong những trạng thái sau:
commentId

string

Mã của chuỗi bình luận. Đây là mã nhận dạng giống với mã nhận dạng của bình luận ban đầu.

Trường nhóm _status.

_status chỉ có thể là một trong những trạng thái sau:
status

enum (Status)

Trạng thái của chuỗi bình luận.

Trường nhóm _head_post.

_head_post chỉ có thể là một trong những trạng thái sau:
headPost

object (Post)

Bài đăng đầu tiên trong chuỗi bình luận.

Đăng

Biểu diễn dưới dạng JSON 
{

  "postId": string

  "content": string

  "authorName": string

  "modifiedTime": string
}
Trường

Trường nhóm _post_id.

_post_id chỉ có thể là một trong những trạng thái sau:
postId

string

Mã của bài đăng.

Trường nhóm _content.

_content chỉ có thể là một trong những trạng thái sau:
content

string

Nội dung của bài đăng.

Trường nhóm _author_name.

_author_name chỉ có thể là một trong những trạng thái sau:
authorName

string

Tên tác giả bài đăng.

Trường nhóm _modified_time.

_modified_time chỉ có thể là một trong những trạng thái sau:
modifiedTime

string (Timestamp format)

Thời gian sửa đổi bài đăng gần đây nhất.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

Dấu thời gian

Biểu diễn dưới dạng JSON 
{
  "seconds": string,
  "nanos": integer
}
Trường
seconds

string (int64 format)

Biểu thị số giây của thời gian UTC kể từ thời gian bắt đầu của hệ thống Unix 1970-01-01T00:00:00Z. Phải nằm trong khoảng từ -62135596800 đến 253402300799 (tương ứng với 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59Z).
nanos

integer

Phân số không âm của một giây ở độ phân giải nano giây. Trường này là phần nano giây của khoảng thời gian, chứ không phải là một lựa chọn thay thế cho giây. Giá trị giây âm có phân số vẫn phải có giá trị nano giây không âm để đếm thời gian. Phải nằm trong khoảng từ 0 đến 999.999.999.

Trạng thái

Xác định trạng thái của một chuỗi bình luận.

Enum
STATUS_UNSPECIFIED
OPEN
RESOLVED

Chú giải công cụ

Gợi ý phá hoại: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

  • 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