تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

الوصف

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

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

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

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

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

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

retrieve-instructions: أداة مساعدة يستخدمها العميل للحصول على تعليمات نظام أساسية حول أفضل طريقة لفهم نية المستخدم وصياغة طلبات فعّالة إلى أداة retrieve-google-maps-platform-docs.
‫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 Studio وCursor) أو تطبيقات الذكاء الاصطناعي على أجهزة الكمبيوتر (مثل Gemini CLI). هذا هو أبسط إعداد وأكثرها شيوعًا.

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

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

‫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 كإضافة في Gemini CLI مع مقدمة ثابتة وأداة MCP وسمة أساسية في "خرائط Google":
```
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"]
    }
  }
}
```
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"
      ]
    }
  }
```
المؤشر
- <-- إذا كان لديك 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"]
    }
  }
}
```
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"]
    }
  }
}
```
أندرويد ستوديو
- أنشئ ملف mcp.json وضَعْه في دليل الإعداد في "استوديو Android". أضِف خادم "مساعد الترميز" إلى القائمة:
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
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"
      ]
    }
  }
}
```
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"
      ]            
    }
  }
}
```
Microsoft Copilot
- عندما تكون في "وضع الوكيل"، انقر على "الأدوات" (Tools)، ثم على "ضبط الأدوات" (Configure Tools) في العنوان الرئيسي العلوي، ثم على "التثبيت من اسم حزمة NPM" (Install from an NPM package name) (راجِع لقطات الشاشة أدناه).
- أدخِل اسم الحزمة @googlemaps/code-assist-mcp واضغط على ENTER، واقبل التثبيت واستخدِم المنفذ التلقائي 3000، ثم اضغط على ENTER للمرّة الأخيرة لتأكيد التغيير
ركوب الأمواج
- مشابهة لتعليمات Cursor أعلاه.
رمز الكيلو
- مشابهة لتعليمات Cline وRoo Code أعلاه