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

الوصف

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

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

تشمل موارد "منصة خرائط 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"، ويعرض سياقًا ذا صلة بالذكاء الاصطناعي لتوليد ردّ دقيق.

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

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

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

الاستخدام

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

المتطلبات

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

شغِّل الخادم على جهازك المحلي واربط العملاء باستخدام بروتوكول 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 - تثبيت خادم MCP الخاص بـ Code Assist كإضافة في 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. المؤشر

    • تثبيت خادم MCP <-- إذا كان لديك 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

    • تجربة الميزة في Firebase Studio مع تثبيت MCP في Code Assist
    • أضِف إلى ملف mcp.json في مشروعك في المجلد .idx في مساحة عملك على Firebase Studio
    {
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}

  5. استوديو Android

    • أنشئ ملف mcp.json وضَعْه في دليل الإعداد في "استوديو Android". أضِف خادم "مساعد الترميز" إلى القائمة:
    {
  "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.