عن المشروع

خادم Google Analytics 4 (GA4) MCP هو خادم بروتوكول سياق النموذج يوفر لوكلاء الذكاء الاصطناعي وصولاً مباشرة وجاهزاً للتحليل إلى خصائص GA4. يُلغي الحاجة إلى معالجة البيانات يدوياً من خلال تقديم اكتشاف المخططات، وتجميع المقاييس من جانب الخادم، وقيم افتراضية آمنة جاهزة للاستخدام. يمكن تثبيت الخادم عبر مثبت عالمي بسطر واحد يُهيئ تلقائياً عملاء MCP الشائعين مثل Claude Desktop، Cursor، Claude Code، VS Code (Cline/Roo Code/Continue)، Zed، وWindsurf. وهو متاح أيضاً كحزمة Python على PyPI وحزمة npm تحت النطاق `@surendranb`. تشمل الأدوات المتاحة تشغيل تقارير GA4 متعددة الأبعاد مع إجماليات آلية، وسرد الحسابات والخصائص، واسترجاع مخططات الأبعاد والمقاييس بالكامل، واستعلام عدد المستخدمين النشطين والأحداث في الوقت الفعلي، والبحث في المهارات التحليلية المدمجة. يتم تحميل المهارات الديناميكية من GitHub وتشمل تشخيص حركة المرور، اكتساب القنوات، تحليل التجارة الإلكترونية، وتحليل الإحالات الذكية (تتبع حركة المرور من ChatGPT، Claude، Perplexity، وGemini). يتطلب المصادقة ملف JSON لحساب خدمة Google ومعرف خاصية GA4، ويتم تكوينه إما عبر متغيرات البيئة أو ملفات تكوين محددة للعميل. يقوم الحزمة بجمع بيانات تليمتري مجهولة وغير شخصية افتراضياً، ويمكن تعطيلها عبر `DO_NOT_TRACK=1` أو `MCP_TELEMETRY_OPT_OUT=1`. الترخيص: MIT.