خادم Google Sheets MCP

ماذا يفعل خادم “Google Sheets” MCP؟

يعد خادم Google Sheets MCP (بروتوكول سياق النماذج) أداة مبنية بلغة TypeScript تمكّن مساعدين الذكاء الاصطناعي من التفاعل الآمن مع Google Sheets عبر أدوات مكتوبة وواضحة. يعمل كجسر بين وكلاء الذكاء الاصطناعي وواجهة Google Sheets/Drive API، مما يسمح بأتمتة قوية وسير عمل متقدم لمعالجة البيانات. يدعم الخادم المصادقة عبر OAuth2 وحساب الخدمة، مما يجعله مرنًا لمتطلبات الأمان المختلفة. تتمثل وظيفته الأساسية في تمكين المطورين وسير عمل الذكاء الاصطناعي من تنفيذ مهام مثل إنشاء جداول البيانات، قراءة وكتابة بيانات الخلايا، إدارة الأوراق/التبويبات، ومشاركة المستندات—كل ذلك بشكل برمجي وآمن. يُبسط هذا التكامل العمليات مثل الاستعلامات شبيهة بقاعدة البيانات، التحرير التعاوني، وأتمتة سير العمل مباشرةً ضمن Google Sheets، مما يعزز الإنتاجية وعمليات التطوير المعتمدة على الذكاء الاصطناعي.

قائمة القوالب الموجهة

لا توجد قوالب موجهة موثقة في المستودع.

قائمة الموارد

لا توجد موارد موثقة بشكل صريح في المستودع.

قائمة الأدوات

• create
  ينشئ جدول بيانات جديد ويمكن نقله اختياريًا إلى مجلد محدد في Drive.
• listSheets
  يعرض جميع تبويبات الأوراق في جدول معين.
• renameSheet
  يعيد تسمية تبويب ورقة موجودة.
• createSheet
  يضيف تبويب ورقة جديد إلى جدول بيانات.
• spreadsheetInfo
  يجلب بيانات التعريف (العنوان، معرفات الأوراق، خصائص الشبكة) لجدول بيانات.
• listSpreadsheets
  يعرض كل جداول البيانات في مجلد Drive الذي أعددته أو في My Drive.
• shareSpreadsheet
  يشارك جدول بيانات مع مستخدمين (قارئ/معلق/كاتب) ويرسل إشعارات.
• sheetData
  يقرأ قيم الخلايا من ورقة ونطاق محدد (أو الورقة كاملة).
• updateCells
  يكتب مصفوفة ثنائية الأبعاد من القيم في نطاق بتنسيق A1.
• batchUpdate
  يطبق تحديثات متعددة على النطاقات في طلب واحد.
• addRows / addColumns
  يدرج صفوفًا أو أعمدة في موقع محدد.
• copySheet
  ينسخ تبويب ورقة بين جداول بيانات مختلفة مع خيار إعادة التسمية.

حالات استخدام هذا الخادم MCP

• إنشاء وإدارة الجداول تلقائيًا
  أنشئ جداول جديدة بسلاسة، أضف أو أعد تسمية الأوراق/التبويبات، ونظم الملفات داخل Google Drive، كل ذلك عبر سير عمل آلي.
• استخراج وتحديث البيانات
  قراءة وكتابة مجموعات بيانات كبيرة من/إلى Google Sheets، ما يجعله مثاليًا لخطوط أنابيب ETL، التقارير، وأتمتة لوحات المعلومات.
• الوصول التعاوني والمشاركة
  شارك جداول البيانات برمجيًا مع مستخدمين مختلفين وحدد الصلاحيات، لتسهيل التعاون بين الفريق والإشعارات التلقائية.
• العمليات الدُفعية ومعالجة البيانات
  نفّذ تحديثات جماعية، أدرج صفوف/أعمدة متعددة، وطبّق تغييرات على أوراق كبيرة بكفاءة، لتوفير الوقت في المهام المتكررة.
• نسخ وتنظيم الأوراق
  انسخ الأوراق بين جداول بيانات لأغراض القوالب، النسخ الاحتياطي، أو سير العمل التنظيمي، مع دعم العمليات القابلة للتوسع عبر الفرق.

كيفية الإعداد

Windsurf

1. تأكد من تثبيت Bun (الإصدار 1.0 أو أحدث) وضبط بيانات اعتماد Google Cloud (إما OAuth2 أو حساب خدمة).
2. استنسخ المستودع وثبّت التبعيات:
   git clone https://github.com/rohans2/mcp-google-sheets.git
cd mcp-google-sheets
bun install
3. قم بضبط متغيرات البيئة كما هو موضح أدناه.
4. في ملف إعداد Windsurf، أضف خادم MCP باستخدام مقطع JSON.
5. احفظ الإعدادات وأعد تشغيل Windsurf.

مثال على إعداد JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

تأمين مفاتيح API باستخدام متغيرات البيئة:

{
  "command": "bun",
  "args": ["index.ts"],
  "env": {
    "CREDENTIALS_CONFIG": "BASE64_ENCODED_CONFIG",
    "EMAIL_ID": "your-email@example.com"
  }
}

Claude

1. ثبّت المتطلبات الأساسية واستنسخ المستودع.
2. قم بضبط مصادقة Google Cloud ومتغيرات البيئة.
3. حدد موقع ملف إعداد Claude MCP وقم بتحريره.
4. أضف خادم Google Sheets MCP مع مقطع الإعداد.
5. أعد تشغيل Claude وتحقق من الاتصال.

مثال على إعداد JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Cursor

1. تأكد من تثبيت Bun وضبط بيانات الاعتماد.
2. قم بتنزيل المستودع وإعداده.
3. حرر ملف إعداد Cursor MCP.
4. أضف إدخال خادم Google Sheets MCP.
5. احفظ التغييرات وأعد تشغيل Cursor لتفعيل الخادم.

مثال على إعداد JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Cline

1. ثبّت Bun وقم بضبط بيانات اعتماد مشروع Google Cloud الخاص بك.
2. استنسخ المستودع وثبّت جميع التبعيات المطلوبة.
3. ادخل إلى ملف إعداد خادم Cline MCP وحرّره.
4. سجل خادم Google Sheets MCP باستخدام تنسيق JSON.
5. أعد تشغيل Cline لتطبيق الإعداد.

مثال على إعداد JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

تأمين مفاتيح API باستخدام متغيرات البيئة:

{
  "command": "bun",
  "args": ["index.ts"],
  "env": {
    "CREDENTIALS_CONFIG": "BASE64_ENCODED_CONFIG",
    "EMAIL_ID": "your-email@example.com"
  }
}

كيفية استخدام MCP داخل التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP ضمن سير عمل FlowHunt، ابدأ بإضافة مكوّن MCP إلى التدفق الخاص بك واربطه بوكيل الذكاء الاصطناعي:

انقر على مكوّن MCP لفتح لوحة الإعدادات. في قسم إعدادات النظام الخاصة بـ MCP، أدخل تفاصيل خادم MCP الخاص بك باستخدام هذا التنسيق JSON:

{
  "google-sheets": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بعد الإعداد، سيتمكن وكيل الذكاء الاصطناعي من استخدام هذا MCP كأداة مع إمكانية الوصول إلى جميع وظائفه وقدراته. تذكر أن تغيّر “google-sheets” إلى اسم خادم MCP الفعلي الخاص بك واستبدل الرابط بالرابط الخاص بك.

نظرة عامة

رأينا

هذا الخادم MCP موثّق جيدًا من حيث الإعداد ويقدم مجموعة قوية من الأدوات لأتمتة Google Sheets. لكنه يفتقر إلى توثيق قوالب وموارد MCP بشكل صريح، ولا يوجد ذكر لدعم العينات أو الجذور. إن تغطيته القوية للأدوات وإرشاداته الواضحة للأمان تجعله ذا قيمة لأتمتة الجداول، لكنه سيصبح أفضل بإضافة توثيق للقوالب/الموارد وتوضيح دعم العينات/الجذور.

تقييم MCP