🔗 المستودع الرسمي
github.com/xing5/mcp-google-sheetsملاحظة: راجع مستودع المشروع الرسمي للحصول على أحدث تعليمات الإعداد والترخيص.
ما هو؟
A Model Context Protocol server for interacting with Google Sheets. This server provides tools to create, read, update, and manage spreadsheets through the Go — هو خادم Model Context Protocol (MCP) يتيح لتطبيقات الذكاء الاصطناعي مثل Claude وCursor الوصول لقدرات databases بشكل آمن ومنظم عبر البروتوكول المفتوح.
لماذا xing5/mcp-google-sheets؟
مباشرة mcp-google-sheets هو خادم MCP قائم على لغة بايثون يربط عملاء الذكاء الاصطناعي مثل Claude Desktop بواجهة برمجة تطبيقات Google Sheets. يتيح للمساعدين الأذكياء التفاعل مع جداول بيانات جوجل وإدارتها وأتمتة المهام من خلال أدوات محددة. يمكن تشغيل الخادم بسهولة باستخدام uvx مع التوثيق عبر حسابات Google Cloud.
حالات الاستخدام الشائعة
- ربط تطبيق Claude Desktop وعملاء MCP الآخرين مباشرة بجداول بيانات جوجل
- أتمتة تعديل وتحديث البيانات داخل جداول البيانات باستخدام سير عمل الذكاء الاصطناعي
- إدارة التكامل مع مجلدات Google Drive لإنشاء وتنظيم ملفات جداول البيانات
التثبيت السريع (Claude Desktop)
{
"mcpServers": {
"mcp-google-sheets": {
"command": "npx",
"args": ["-y", "xing5/mcp-google-sheets"]
}
}
}أضف الكود لملف إعدادات Claude Desktop بعد تثبيت المتطلبات حسب تعليمات المستودع.
أسئلة شائعة
كيف يمكنني تشغيل خادم mcp-google-sheets؟
قم بتثبيت أداة uv، واضبط متغيرات البيئة، ثم نفّذ الأمر `uvx mcp-google-sheets@latest` في موجه الأوامر.
ما هي طريقة التوثيق الموصى بها؟
يوصى بشدة باستخدام حساب خدمة (Service Account) من Google Cloud وتعيين متغير البيئة `SERVICE_ACCOUNT_PATH`.
ما هي متغيرات البيئة الأساسية المطلوبة للبدء؟
يلزم تعيين متغير `SERVICE_ACCOUNT_PATH` للتحقق من الهوية ومتغير `DRIVE_FOLDER_ID` لتحديد مجلد Google Drive.