این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

کیت ابزار کمک کد پلتفرم Google Maps

توضیحات

جعبه ابزار Code Assist پلتفرم نقشه‌های گوگل، یک سرور پروتکل زمینه مدل (MCP) است که با پایه‌گذاری پاسخ‌ها در مستندات رسمی و به‌روز و نمونه‌های کد، پاسخ‌های مدل‌های زبانی بزرگ (LLM) مورد استفاده برای توسعه برنامه‌ها با پلتفرم نقشه‌های گوگل را بهبود می‌بخشد.

از آنجایی که سرور MCP هنگام فراخوانی مدل به محتوا دسترسی پیدا می‌کند، زمینه LLM در مورد پلتفرم نقشه‌های گوگل نباید محدود به داده‌های موجود در تاریخ آموزش مدل باشد.

منابع پلتفرم نقشه‌های گوگل که سرور MCP می‌تواند به آنها دسترسی داشته باشد عبارتند از:

مستندات پلتفرم نقشه‌های گوگل
شرایط خدمات پلتفرم نقشه‌های گوگل
مرکز اعتماد پلتفرم نقشه‌های گوگل
مخازن کد در پلتفرم نقشه‌های گوگل، سازمان‌های رسمی گیت‌هاب

🔧 ابزار ارائه شده

سرور MCP ابزارهای زیر را برای کلاینت‌های هوش مصنوعی ارائه می‌دهد:

retrieve-instructions : یک ابزار کمکی که توسط کلاینت برای دریافت دستورالعمل‌های حیاتی سیستم در مورد چگونگی بهترین استدلال در مورد قصد کاربر و تدوین فراخوانی‌های مؤثر به ابزار retrieve-google-maps-platform-docs استفاده می‌شود.
retrieve-google-maps-platform-docs : ابزار اصلی. این ابزار یک پرس‌وجوی زبان طبیعی را دریافت کرده و آن را به یک موتور میزبان بازیابی افزوده نسل (RAG) ارسال می‌کند. موتور RAG نسخه‌های جدید اسناد رسمی پلتفرم نقشه‌های گوگل، آموزش‌ها و نمونه‌های کد را جستجو می‌کند و زمینه مرتبط را به هوش مصنوعی برمی‌گرداند تا پاسخ دقیقی تولید کند.

🛠️ حمل و نقل‌های MCP پشتیبانی شده

این سرور از دو پروتکل ارتباطی استاندارد MCP پشتیبانی می‌کند:

stdio : این روش انتقال پیش‌فرض است که هنگام فراخوانی سرور توسط کلاینت از طریق یک command استفاده می‌شود. این روش از طریق جریان‌های ورودی/خروجی استاندارد ارتباط برقرار می‌کند و آن را برای اجرای خط فرمان محلی ایده‌آل می‌سازد.
Streamable HTTP : سرور یک نقطه پایانی /mcp را در معرض نمایش قرار می‌دهد که درخواست‌های POST را می‌پذیرد. این توسط کلاینت‌هایی که از طریق یک url متصل می‌شوند استفاده می‌شود و استانداردی برای اتصالات سرور از راه دور است. پیاده‌سازی ما از پخش جریانی برای پاسخ‌های تعاملی و بلادرنگ پشتیبانی می‌کند.

🚀 کاربرد

شما می‌توانید سرور Code Assist MCP را یا روی دستگاه توسعه محلی خود یا از راه دور روی Google Cloud Run اجرا کنید.

الزامات

برای استفاده از ابزار کمکی کد پلتفرم نقشه‌های گوگل، به محیطی با Node.js (نسخه LTS توصیه می‌شود) و npm نصب شده برای کلون کردن و اجرای سرور و همچنین یک کلاینت MCP برای دسترسی به سرور نیاز دارید.

استفاده از Code Assist به عنوان یک سرور محلی MCP با انتقال `stdio` (توصیه شده)

سرور را روی دستگاه محلی خود اجرا کنید و کلاینت‌ها را با استفاده از پروتکل stdio برای استفاده با IDE های مبتنی بر هوش مصنوعی (مانند VS Code، Android Studio، Cursor) یا برنامه‌های هوش مصنوعی دسکتاپ (مانند Gemini CLI) متصل کنید. این ساده‌ترین و رایج‌ترین تنظیمات است.

کلاینت خود را پیکربندی کنید

سرور را به فایل پیکربندی MCP کلاینت هوش مصنوعی مورد نظر خود اضافه کنید. برای دستورالعمل‌های خاص و تأیید شده، کلاینت خود را در زیر پیدا کنید.

دستیار کد Gemini و رابط خط فرمان Gemini
- گزینه ۱ - سرور را مستقیماً از خط فرمان خود اضافه کنید (با فرض اینکه Gemini CLI را از قبل نصب کرده‌اید):
```
 gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
```
  - با اجرای دستور gemini mcp list از صحت نصب اطمینان حاصل کنید.
- گزینه ۲ - نصب Code Assist به عنوان یک افزونه Gemini CLI با مقدمه استاتیک، ابزار MCP و تم اولیه Google Maps:
```
gemini extensions install https://github.com/googlemaps/platform-ai.git
```
- گزینه ۳ - پیکربندی سرور MCP را به صورت دستی به فایل ~/.gemini/settings.json خود اضافه کنید.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
کلود کد
- گزینه ۱ - سرور را مستقیماً از خط فرمان خود اضافه کنید (با فرض اینکه Claude Code را از قبل نصب کرده‌اید):
```
    claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
```
  - با اجرای دستور claude mcp list نصب را تأیید کنید.
  - کاربران ویندوز: در ویندوز اصلی (نه WSL)، برای اینکه دستورات npx به درستی کار کنند، باید از بسته‌بندی cmd /c استفاده کنید.
```
claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
```
- گزینه ۲ - سرور را به صورت دستی به فایل پیکربندی 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"]
    }
  }
}
```
استودیوی فایربیس
- با نصب 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 ایجاد کنید و آن را در دایرکتوری پیکربندی اندروید استودیو قرار دهید. سرور Code Assist را به لیست اضافه کنید:
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
کلاین
- گزینه ۱: نصب با استفاده از رابط کاربری گرافیکی Cline MCP
- گزینه ۲: نصب دستی/برنامه‌ای با استفاده از فایل پیکربندی Cline MCP. فایل پیکربندی در آدرس زیر قرار دارد:
  - macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  - ویندوز: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  - لینوکس: ~/.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 MCP
- گزینه ۲: نصب دستی/برنامه‌ای با استفاده از فایل پیکربندی Roo Code. فایل پیکربندی در آدرس زیر قرار دارد:
  - macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
  - ویندوز: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
  - لینوکس: ~/.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"
      ]            
    }
  }
}
```
کمک خلبان مایکروسافت
- وقتی در حالت Agent هستید، روی «Tools» کلیک کنید و سپس در سربرگ بالا «Configure Tools» و سپس «Install from an NPM package name» را انتخاب کنید (تصاویر زیر را ببینید)
- نام pacakge را @googlemaps/code-assist-mcp وارد کنید و ENTER را بزنید، نصب را بپذیرید و از پورت پیش‌فرض ۳۰۰۰ استفاده کنید، سپس برای آخرین بار ENTER را بزنید تا تغییر را تأیید کنید
موج‌سواری
- مشابه دستورالعمل‌های مکان‌نما در بالا.
کد کیلو
- مشابه دستورالعمل‌های Cline و Roo Code در بالا