مجموعة أدوات Code Assist في "منصة خرائط Google"

الوصف

مجموعة أدوات "مساعد الترميز" في "منصة خرائط Google" هي خادم "بروتوكول سياق النموذج" (MCP) الذي يحسّن الردود من النماذج اللغوية الكبيرة (LLM) المستخدَمة في تطوير التطبيقات باستخدام "منصة خرائط Google" من خلال استناد الردود إلى المستندات الرسمية والحديثة ونماذج الرموز البرمجية.

بما أنّ خادم MCP يصل إلى المحتوى عند طلب النموذج، لا يجب أن يقتصر سياق النموذج اللغوي الكبير (LLM) المتعلّق بمنصة Google Maps على البيانات المتاحة في تاريخ تدريب النموذج.

تشمل موارد "منصة خرائط Google" التي يمكن لخادم MCP الوصول إليها ما يلي:

• مستندات Google Maps Platform
• بنود خدمة "منصة خرائط Google"
• مركز الأمان في "منصة خرائط Google"
• مستودعات الرموز البرمجية في مؤسسات GitHub الرسمية على "منصة خرائط Google"

الأدوات المتوفّرة

يعرض خادم MCP الأدوات التالية لعملاء الذكاء الاصطناعي:

1. retrieve-instructions: أداة مساعدة يستخدمها العميل للحصول على تعليمات نظام أساسية حول أفضل طريقة لفهم الغرض من طلب المستخدم وصياغة طلبات فعّالة إلى أداة retrieve-google-maps-platform-docs.
2. ‫retrieve-google-maps-platform-docs: الأداة الأساسية تتلقّى هذه الأداة طلب بحث باللغة الطبيعية وترسله إلى محرّك "التوليد المعزّز بالاسترجاع" (RAG) مستضاف. يبحث محرّك التوليد المعزّز بالاسترجاع عن أحدث إصدارات المستندات الرسمية والبرامج التعليمية ونماذج الرموز البرمجية الخاصة بمنصة Google Maps، ويعرض السياق المناسب للذكاء الاصطناعي من أجل إنشاء ردّ دقيق.

وسائل نقل MCP المتوافقة

يتوافق هذا الخادم مع بروتوكولَي اتصال عاديَين لوحدة التحكّم في الإدارة (MCP):

• stdio: هذا هو النقل التلقائي المستخدَم عندما يستدعي العميل الخادم من خلال command. يتواصل هذا الوضع عبر عمليات نقل البيانات القياسية، ما يجعله مثاليًا لتنفيذ الأوامر المحلية من سطر الأوامر.
• استبدِل Streamable HTTP بما يلي: يعرض الخادم نقطة نهاية /mcp تقبل طلبات POST. يتم استخدام هذا البروتوكول من قِبل العملاء الذين يتصلون عبر url، وهو المعيار لاتصالات الخادم البعيد. يتيح التنفيذ الذي نقدّمه بث الردود التفاعلية في الوقت الفعلي.

الاستخدام

يمكنك تشغيل خادم MCP الخاص بـ "مساعد الترميز" إما على جهاز التطوير المحلي أو عن بُعد على Google Cloud Run.

المتطلبات

لاستخدام مجموعة أدوات "مساعد الترميز" في Google Maps Platform، تحتاج إلى بيئة مثبَّت فيها Node.js (يُنصح باستخدام إصدار LTS) وnpm لاستنساخ الخادم وتشغيله، بالإضافة إلى عميل MCP للوصول إلى الخادم.

استخدام Code Assist كخادم MCP محلي مع نقل stdio (يُنصح به)

شغِّل الخادم على جهازك المحلي واربط العملاء باستخدام بروتوكول stdio لاستخدامه مع بيئات التطوير المتكاملة (IDE) المستنِدة إلى الذكاء الاصطناعي (مثل VS Code أو "استوديو Android" أو Cursor) أو تطبيقات الذكاء الاصطناعي على أجهزة الكمبيوتر (مثل Gemini CLI). هذا هو الإعداد الأبسط والأكثر شيوعًا.

إعداد برنامجك

أضِف الخادم إلى ملف إعداد MCP الخاص بعميل الذكاء الاصطناعي المفضّل لديك. ابحث عن عميلك أدناه للحصول على تعليمات محدّدة تم التحقّق منها.

1. ‫Gemini Code Assist وGemini CLI

   • الخيار 1: إضافة الخادم مباشرةً من سطر الأوامر (بافتراض أنّك ثبّت Gemini CLI من قبل):

      gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
     

     • تحقَّق من عملية التثبيت عن طريق تشغيل gemini mcp list.
   • الخيار 2: تثبيت خادم Code Assist MCP كإضافة في Gemini CLI:

     gemini extensions install https://github.com/googlemaps/platform-ai.git
     

   • الخيار 3: إضافة إعدادات خادم MCP يدويًا إلى ملف ~/.gemini/settings.json

   {
     "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
       }
     }
   }
   

2. Claude Code

   • الخيار 1 - إضافة الخادم مباشرةً من سطر الأوامر (بافتراض أنّك ثبّت Claude Code من قبل):

         claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
     

     • تحقَّق من عملية التثبيت عن طريق تنفيذ claude mcp list.
     • مستخدمو Windows: على نظام التشغيل Windows الأصلي (وليس WSL)، يجب استخدام برنامج تضمين cmd /c لأوامر npx لكي تعمل بشكل صحيح.

     claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
     

   • الخيار 2 - إضافة الخادم يدويًا إلى ملف إعدادات Claude ~/.claude.json

   "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": [
           "-y", "@googlemaps/code-assist-mcp@latest"
         ]
       }
     }
   

3. المؤشر

   • <-- إذا كان لديك Cursor مثبَّتًا، انقر هنا لتثبيت Google Maps Platform Code Assist MCP مباشرةً.
   • بخلاف ذلك، أضِفه إلى ملف .cursor-settings/mcp.json في مساحة عملك.

   {
     "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
       }
     }
   }
   

4. Firebase Studio

   • مع تثبيت Code Assist MCP
   • أضِف إلى ملف mcp.json في مشروعك في المجلد .idx في مساحة عملك على Firebase Studio

   {
     "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
       }
     }
   }
   

5. استوديو Android

   • أنشئ ملف mcp.json وضَعْه في دليل الإعداد في &quot;استوديو Android&quot;. أضِف خادم "مساعد الترميز" إلى القائمة:

   {
     "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
       }
     }
   }
   

6. Cline

   • الخيار 1: التثبيت باستخدام واجهة المستخدم الرسومية لـ Cline MCP
   • الخيار 2: التثبيت يدويًا أو آليًا باستخدام ملف إعداد Cline MCP يقع ملف الإعداد في:
     • نظام التشغيل macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
     • Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
     • ‫Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
     • أضِف ما يلي إلى إعدادات MCP في cline_mcp_settings.json:

       {
         "mcpServers": {
           "google-maps-platform-code-assist": {
             "command": "npx",
             "args": ["-y", "@googlemaps/code-assist-mcp@latest"],
             "alwaysAllow": [
               "retrieve-instructions",
               "retrieve-google-maps-platform-docs"
             ]
           }
         }
       }
       

7. Roo Code

   • الخيار 1: التثبيت باستخدام واجهة المستخدم الرسومية لـ Roo MCP
   • الخيار 2: التثبيت يدويًا أو آليًا باستخدام ملف إعدادات Roo Code يقع ملف الإعداد في:
     • نظام التشغيل macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
     • Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
     • ‫Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
     • أضِف ما يلي إلى إعدادات MCP في mcp_settings.json:

       {
         "mcpServers": {
           "google-maps-platform-code-assist": {
             "command": "npx",
             "args": ["-y", "@googlemaps/code-assist-mcp@latest"],
             "alwaysAllow": [
               "retrieve-instructions",
               "retrieve-google-maps-platform-docs"
             ]            
           }
         }
       }
       

8. Microsoft Copilot

   • عندما تكون في "وضع الوكيل"، انقر على "الأدوات"، ثم على "ضبط الأدوات" في العنوان العلوي، ثم على "التثبيت من اسم حزمة NPM" (راجِع لقطات الشاشة أدناه).

   • 
   • 
   • 

   • أدخِل اسم الحزمة @googlemaps/code-assist-mcp واضغط على ENTER، واقبل التثبيت واستخدِم المنفذ التلقائي 3000، ثم اضغط على ENTER مرة أخيرة لتأكيد التغيير

   • 

9. ركوب الأمواج

   • مشابهة لتعليمات Cursor أعلاه.

10. رمز الكيلو

    • مشابهة لتعليمات Cline وRoo Code أعلاه

مزيد من المعلومات

لمزيد من المعلومات حول تثبيت مجموعة الأدوات واستخدامها، بالإضافة إلى بنود الاستخدام، يُرجى الاطّلاع على ملف README في مستودع GitHub.