Toolkit Bantuan Kode Google Maps Platform

Deskripsi

Google Maps Platform Code Assist toolkit adalah server Model Context Protocol (MCP) yang meningkatkan kualitas respons dari model bahasa besar (LLM) yang digunakan untuk mengembangkan aplikasi dengan Google Maps Platform dengan mendasarkan respons pada dokumentasi dan contoh kode resmi yang terbaru.

Karena server MCP mengakses konten saat model diminta, konteks LLM terkait Google Maps Platform tidak harus dibatasi ke data yang tersedia pada tanggal pelatihan model.

Resource Google Maps Platform yang dapat diakses server MCP mencakup:

  • Dokumentasi Google Maps Platform
  • Persyaratan Layanan Google Maps Platform
  • Pusat Kepercayaan Google Maps Platform
  • Repositori kode di organisasi GitHub resmi Google Maps Platform

Alat yang Disediakan

Server MCP mengekspos alat berikut untuk klien AI:

  1. retrieve-instructions: Alat bantu yang digunakan oleh klien untuk mendapatkan petunjuk sistem penting tentang cara terbaik untuk memahami maksud pengguna dan merumuskan panggilan yang efektif ke alat retrieve-google-maps-platform-docs.
  2. retrieve-google-maps-platform-docs: Alat utama. Alat ini mengambil kueri bahasa alami dan mengirimkannya ke mesin Retrieval Augmented Generation (RAG) yang dihosting. Mesin RAG menelusuri versi terbaru dokumentasi, tutorial, dan contoh kode Google Maps Platform resmi, yang menampilkan konteks yang relevan ke AI untuk menghasilkan respons yang akurat.

Transportasi MCP yang Didukung

Server ini mendukung dua protokol komunikasi MCP standar:

  • stdio: Ini adalah transportasi default yang digunakan saat klien memanggil server melalui command. Protokol ini berkomunikasi melalui aliran input/output standar, sehingga ideal untuk eksekusi command line lokal.
  • Streamable HTTP: Server mengekspos endpoint /mcp yang menerima permintaan POST. Endpoint ini digunakan oleh klien yang terhubung melalui url dan merupakan standar untuk koneksi server jarak jauh. Implementasi kami mendukung streaming untuk respons interaktif real-time.

Penggunaan

Anda dapat menjalankan server MCP Code Assist di mesin pengembangan lokal atau dari jarak jauh di Google Cloud Run.

Persyaratan

Untuk menggunakan Google Maps Platform Code Assist toolkit, Anda memerlukan lingkungan dengan Node.js (versi LTS direkomendasikan) dan npm yang diinstal untuk meng-clone dan menjalankan server, serta klien MCP untuk mengakses server.

Jalankan server di mesin lokal dan hubungkan klien menggunakan protokol stdio untuk digunakan dengan IDE yang dibantu AI (seperti VS Code, Android Studio, Cursor) atau aplikasi AI desktop (seperti Gemini CLI). Penyiapan ini adalah penyiapan yang paling sederhana dan paling umum.

Mengonfigurasi Klien

Tambahkan server ke file konfigurasi MCP klien AI pilihan Anda. Temukan klien Anda di bawah untuk mendapatkan petunjuk khusus yang telah diverifikasi.

  1. Gemini Code Assist &Gemini CLI

    • Opsi 1 - Tambahkan server langsung dari command line Anda (dengan asumsi Anda telah menginstal Gemini CLI):
       gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
      
      • Verifikasi penginstalan dengan menjalankan gemini mcp list.
    • Opsi 2 - Instal server MCP Code Assist sebagai ekstensi Gemini CLI:
      gemini extensions install https://github.com/googlemaps/platform-ai.git
      
    • Opsi 3 - Tambahkan konfigurasi server MCP secara manual ke file ~/.gemini/settings.json Anda.
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  2. Claude Code

    • Opsi 1 - Tambahkan server langsung dari command line Anda (dengan asumsi Anda telah menginstal Claude Code):
          claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
      
      • Verifikasi penginstalan dengan menjalankan claude mcp list.
      • Pengguna Windows: Di Windows native (bukan WSL), Anda harus menggunakan wrapper cmd /c agar perintah npx berfungsi dengan benar.
      claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
      
    • Opsi 2 - Tambahkan server secara manual ke file konfigurasi Claude ~/.claude.json
    "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": [
            "-y", "@googlemaps/code-assist-mcp@latest"
          ]
        }
      }
    
  3. Cursor

    • Menginstal Server MCP <-- Jika Anda sudah menginstal Cursor, klik di sini untuk menginstal Google Maps Platform Code Assist MCP secara langsung.
    • Jika tidak, tambahkan ke file .cursor-settings/mcp.json ruang kerja Anda.
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  4. Firebase Studio

    • Coba di Firebase Studio dengan Code Assist MCP terinstal
    • Tambahkan ke file mcp.json project Anda di folder .idx di ruang kerja Firebase Studio
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  5. Android Studio

    • Buat file mcp.json dan tempatkan di direktori konfigurasi Android Studio. Tambahkan server Code Assist ke daftar:
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  6. Cline

    • Opsi 1: instal menggunakan Cline MCP GUI
    • Opsi 2: instal secara manual / terprogram menggunakan file konfigurasi Cline MCP. File konfigurasi terletak di:
      • 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
      • Tambahkan hal berikut ke konfigurasi MCP Anda di 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

    • Opsi 1: instal menggunakan Roo MCP GUI
    • Opsi 2: instal secara manual / terprogram menggunakan file konfigurasi Roo Code. File konfigurasi terletak di:
      • 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
      • Tambahkan hal berikut ke konfigurasi MCP Anda di 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

    • Saat dalam mode Agen, klik "Alat", lalu di header atas "Konfigurasi Alat", lalu "Instal dari nama paket NPM" (Lihat screenshot di bawah)

    • gambar
    • gambar
    • gambar
    • Masukkan nama paket @googlemaps/code-assist-mcp dan tekan ENTER, terima penginstalan dan gunakan port default 3000, lalu tekan ENTER sekali lagi untuk mengonfirmasi perubahan

    • gambar
  9. Windsurf

    • Mirip dengan petunjuk Cursor di atas.
  10. Kilo Code

    • Mirip dengan petunjuk Cline dan Roo Code di atas

Pelajari lebih lanjut

Untuk mengetahui informasi selengkapnya tentang cara menginstal dan menggunakan toolkit, serta persyaratan penggunaan, lihat README repositori GitHub README.