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

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

توضیحات

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

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

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

اسناد پلتفرم نقشه های گوگل
شرایط خدمات پلتفرم Google Maps
مرکز اعتماد پلتفرم نقشه های گوگل
مخازن کد در سازمان های رسمی GitHub پلتفرم نقشه های گوگل

توسعه دهندگان

🪄 دستیار هوش مصنوعی یا IDE مورد علاقه خود را به متخصص پلتفرم نقشه های گوگل تبدیل کنید. با Code Assist، عوامل هوش مصنوعی مانند Gemini CLI، Claude Code، و Cursor می‌توانند کد ایجاد کنند و به سؤالات توسعه‌دهنده پاسخ دهند که مبتنی بر اسناد و نمونه‌های کد به‌روز و رسمی پلتفرم نقشه‌های Google هستند - مستقیماً در جریان کاری برنامه‌نویس شما.
🚀 چه در حال ایجاد تغییرات دقیق کد با کمک هوش مصنوعی یا کدگذاری یک نمونه اولیه برنامه جدید باشید - Code Assist می تواند به شما کمک کند تا کار خود را سریعتر و آسان تر انجام دهید.

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

سرور MCP ابزارهای زیر را برای مشتریان AI در معرض دید قرار می دهد:

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

🛠️ پشتیبانی از MCP Transports

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

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

🚀 استفاده

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

الزامات

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

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

سرور را روی دستگاه محلی خود اجرا کنید و کلاینت ها را با استفاده از پروتکل stdio برای استفاده با IDE های به کمک هوش مصنوعی (مانند VS Code، Android Studio، مکان نما) یا برنامه های AI دسکتاپ (مانند 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"]
    }
  }
}
```
کد کلود
- گزینه 1 - سرور را مستقیماً از خط فرمان خود اضافه کنید (با فرض اینکه کد کلود قبلاً نصب شده است):
```
    claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist@latest
```
  - نصب را با اجرای claude mcp list تأیید کنید.
  - کاربران ویندوز: در ویندوز بومی (نه WSL)، باید از wrapper 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"
      ]
    }
  }
```
مکان نما
- <-- اگر مکان‌نما را قبلاً نصب کرده‌اید، اینجا را کلیک کنید تا مستقیماً 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
- با 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"]
    }
  }
}
```
کلین
- گزینه 1: با استفاده از رابط کاربری گرافیکی Cline MCP نصب کنید
- گزینه 2: به صورت دستی / برنامه ای با استفاده از فایل پیکربندی 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"
    ]
  }
}
```
رو کد
- گزینه 1: با استفاده از رابط کاربری گرافیکی Roo MCP نصب کنید
- گزینه 2: به صورت دستی / برنامه ای با استفاده از فایل پیکربندی 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 هستید، روی "ابزارها" و سپس در هدر بالای "پیکربندی ابزارها" و سپس "نصب از یک نام بسته NPM" کلیک کنید (تصاویر زیر را ببینید)
- نام بسته را وارد کنید @googlemaps/code-assist-mcp و ENTER را وارد کنید، نصب را بپذیرید و از پورت پیش‌فرض 3000 استفاده کنید، سپس برای آخرین بار برای تأیید تغییر وارد کنید.
موج سواری
- مشابه دستورالعمل مکان نما در بالا.
کد کیلویی
- مشابه دستورالعمل های Cline و Roo Code در بالا

بیشتر بدانید

برای اطلاعات بیشتر در مورد نصب و استفاده از جعبه ابزار، و همچنین شرایط استفاده، به مخزن GitHub README مراجعه کنید.

کیت ابزار کمک کد پلتفرم Google Maps با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.