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

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

الوصف

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

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

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

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

المطوّرون

🪄 يمكنك تحويل مساعدك المفضّل المستند إلى الذكاء الاصطناعي أو بيئة التطوير المتكاملة (IDE) إلى خبير في "منصة خرائط Google". باستخدام Code Assist، يمكن لوكلاء الذكاء الاصطناعي، مثل Gemini CLI وClaude Code وCursor، إنشاء الرموز البرمجية والإجابة عن أسئلة المطوّرين استنادًا إلى أحدث مستندات وأمثلة رموز برمجية رسمية من Google Maps Platform، وذلك مباشرةً في سير عمل التطوير.
🚀 سواء كنت تريد إجراء تغييرات دقيقة على الرمز البرمجي بمساعدة الذكاء الاصطناعي أو إنشاء نموذج أولي لتطبيق جديد، يمكن أن يساعدك Code Assist في إنجاز مهمتك بشكل أسرع وأسهل.

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

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

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

🛠️ بروتوكولات نقل MCP المتوافقة

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

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

🚀 الاستخدام

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

المتطلبات

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

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

شغِّل الخادم على جهازك المحلي واربط العملاء باستخدام بروتوكول stdio لاستخدامه مع بيئات التطوير المتكاملة (IDE) المستنِدة إلى الذكاء الاصطناعي (مثل VS Code أو "استوديو Android" أو 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: أضِف إعدادات خادم 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@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-mc@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"]
    }
  }
}
```
استوديو Android
- أنشئ ملف 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
- عندما تكون في "وضع الوكيل"، انقر على "الأدوات"، ثم على "ضبط الأدوات" في العنوان العلوي، ثم على "التثبيت من اسم حزمة NPM" (راجِع لقطات الشاشة أدناه).
- أدخِل اسم الحزمة @googlemaps/code-assist-mcp واضغط على ENTER، واقبل التثبيت واستخدِم المنفذ التلقائي 3000، ثم اضغط على ENTER للمرّة الأخيرة لتأكيد التغيير
ركوب الأمواج
- مشابهة لتعليمات Cursor أعلاه.
رمز الكيلو
- مشابهة لتعليمات Cline وRoo Code أعلاه