Home
Login

خادم بروتوكول سياق نموذج إدارة مهام Google لـ Claude

MITTypeScript 63zcaceres Last Updated: 2025-02-02

gtasks-mcp - خادم بروتوكول سياق نموذج مهام Google

نظرة عامة على المشروع

gtasks-mcp هو خادم بروتوكول سياق نموذج (MCP) لمهام Google مصمم خصيصًا لـ Claude AI. يسمح هذا المشروع لـ Claude بالاندماج مباشرة مع Google Tasks API، مما يتيح وظائف إدارة كاملة لمهام Google.

عنوان المشروع: https://github.com/zcaceres/gtasks-mcp

الوظائف الرئيسية

الأدوات الأساسية (Tools)

1. search - البحث عن المهام

  • وصف الوظيفة: البحث عن المهام في مهام Google
  • معلمات الإدخال:
    • query (سلسلة): سلسلة استعلام البحث
  • نتائج الإرجاع: معلومات تفصيلية عن المهام المطابقة

2. list - سرد المهام

  • وصف الوظيفة: سرد جميع المهام في مهام Google
  • معلمات الإدخال:
    • cursor (سلسلة، اختياري): مؤشر ترقيم الصفحات
  • نتائج الإرجاع: قائمة بجميع المهام

3. create - إنشاء مهمة

  • وصف الوظيفة: إنشاء مهمة جديدة في مهام Google
  • معلمات الإدخال:
    • taskListId (سلسلة، اختياري): مُعرّف قائمة المهام
    • title (سلسلة، إلزامي): عنوان المهمة
    • notes (سلسلة، اختياري): ملاحظات المهمة
    • due (سلسلة، اختياري): تاريخ الاستحقاق
  • نتائج الإرجاع: معلومات تأكيد إنشاء المهمة

4. update - تحديث مهمة

  • وصف الوظيفة: تحديث مهمة Google Tasks موجودة
  • معلمات الإدخال:
    • taskListId (سلسلة، اختياري): مُعرّف قائمة المهام
    • id (سلسلة، إلزامي): مُعرّف المهمة
    • uri (سلسلة، إلزامي): URI المهمة
    • title (سلسلة، اختياري): عنوان المهمة الجديد
    • notes (سلسلة، اختياري): ملاحظات المهمة الجديدة
    • status (سلسلة، اختياري): حالة المهمة الجديدة ("needsAction" أو "completed")
    • due (سلسلة، اختياري): تاريخ الاستحقاق الجديد
  • نتائج الإرجاع: معلومات تأكيد تحديث المهمة

5. delete - حذف مهمة

  • وصف الوظيفة: حذف مهمة في مهام Google
  • معلمات الإدخال:
    • taskListId (سلسلة، إلزامي): مُعرّف قائمة المهام
    • id (سلسلة، إلزامي): مُعرّف المهمة
  • نتائج الإرجاع: معلومات تأكيد حذف المهمة

6. clear - مسح المهام المكتملة

  • وصف الوظيفة: مسح المهام المكتملة في قائمة مهام Google
  • معلمات الإدخال:
    • taskListId (سلسلة، إلزامي): مُعرّف قائمة المهام
  • نتائج الإرجاع: معلومات تأكيد عملية المسح

الموارد (Resources)

يوفر الخادم الوصول إلى موارد مهام Google:

  • مورد المهمة (gtasks:///<task_id>)
    • يمثل مهمة واحدة في مهام Google
    • يدعم قراءة تفاصيل المهمة، بما في ذلك العنوان والحالة وتاريخ الاستحقاق والملاحظات والبيانات الوصفية الأخرى
    • يمكن استخدام الأدوات المتوفرة لسرد وقراءة وإنشاء وتحديث وحذف المهام

التثبيت والتكوين

المتطلبات الأساسية

  1. إنشاء مشروع Google Cloud

  2. تمكين Google Tasks API

  3. تكوين شاشة موافقة OAuth

    • قم بالتكوين في شاشة موافقة OAuth
    • حدد "internal" لبيئة الاختبار
    • إضافة نطاق: https://www.googleapis.com/auth/tasks
  4. إنشاء مُعرّف عميل OAuth

    • قم بإنشاء في صفحة بيانات الاعتماد
    • حدد "تطبيق سطح المكتب" لنوع التطبيق
    • قم بتنزيل ملف JSON لمفتاح OAuth
    • أعد تسمية ملف المفتاح إلى gcp-oauth.keys.json وضعه في الدليل الجذر للمشروع

بناء المشروع

استخدم الأمر التالي لبناء الخادم:

npm run build

أو استخدم وضع المراقبة:

npm run watch

التثبيت التلقائي (موصى به)

قم بالتثبيت التلقائي عبر Smithery:

npx -y @smithery/cli install @zcaceres/gtasks --client claude

المصادقة

  1. قم بتشغيل الخادم والمصادقة:
npm run start auth
  1. سيؤدي هذا إلى فتح عملية المصادقة في متصفح النظام
  2. أكمل عملية المصادقة
  3. سيتم حفظ بيانات الاعتماد في الدليل الجذر للمشروع (.gdrive-server-credentials.json)

تكامل Claude Desktop

لدمج هذا الخادم مع تطبيق Claude Desktop، أضف ما يلي إلى تكوين الخادم في التطبيق:

{
  "mcpServers": {
    "gtasks": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

الميزات التقنية

  • عمليات CRUD كاملة: يدعم إنشاء وقراءة وتحديث وحذف المهام
  • وظيفة البحث المتقدم: يمكن البحث عن المهام بناءً على الكلمات الرئيسية
  • إدارة حالة المهمة: يدعم وضع علامة على المهام كمكتملة أو معلقة
  • دعم الترقيم: يوفر وظيفة الترقيم عند التعامل مع عدد كبير من المهام
  • مصادقة OAuth 2.0: وصول آمن إلى Google API
  • دعم TypeScript: يوفر أمان النوع وتجربة تطوير أفضل

سيناريوهات الاستخدام

  • إدارة المهام الشخصية: إدارة المهام اليومية من خلال تفاعل اللغة الطبيعية مع Claude
  • التعاون في المشاريع: إدارة توزيع المهام في مشاريع الفريق من خلال مساعد الذكاء الاصطناعي
  • أتمتة سير العمل: الجمع بين الأدوات الأخرى لأتمتة إدارة المهام
  • تحسين الإنتاجية: إنشاء وتحديث المهام بسرعة عن طريق الصوت أو النص

تنبيهات

  • يتطلب حساب Google صالحًا وإذن الوصول إلى مهام Google
  • يتطلب الاستخدام الأول إكمال عملية مصادقة OAuth
  • يوصى بحماية ملف بيانات اعتماد المصادقة بشكل صحيح في بيئة الإنتاج
  • اتبع حصص وقيود استخدام Google API