MCP Tools Reference: docsmcp.googleapis.com

الأداة: read_doc

تستردّ هذه الأداة تمثيلاً بتنسيق JSON لمستند Google معيّن باستخدام رقم تعريف المستند.

يتضمّن التمثيل بتنسيق JSON كلاً من النص والمعلومات الهيكلية حول المستند.

يتطابق هذا مع documents.get في واجهة برمجة تطبيقات REST.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة MCP read_doc.

طلب Curl 
curl --location 'https://docsmcp.googleapis.com/mcp' \
--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_doc",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

ReadDocRequest

تمثيل JSON 
{
  "documentId": string
}
الحقول
documentId

string

الحقل مطلوب. رقم تعريف المستند المطلوب قراءته هذا هو نفسه file_id من أدوات Drive.

مخطط النتائج

ReadDocResponse

تمثيل JSON 
{
  "content": string
}
الحقول
content

string

المحتوى النصي للمستند بصيغة كلامية

التعليقات التوضيحية للأداة

تلميح بشأن الإجراءات المدمّرة: ❌ | تلميح بشأن الإجراءات غير المدمّرة: ✅ | تلميح بشأن الإجراءات للقراءة فقط: ✅ | تلميح بشأن الإجراءات في العالم المفتوح: ✅

نطاقات التفويض

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/documents.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/documents