Google Haritalar Platformu Code Assist araç seti

Açıklama

Google Haritalar Platformu Code Assist araç seti, Google Haritalar Platformu ile uygulamalar geliştirmek için kullanılan büyük dil modellerinden (LLM) gelen yanıtları, resmi ve güncel belgeler ile kod örneklerine dayandırarak iyileştiren bir Model Context Protocol (MCP) sunucusudur.

MCP sunucusu, model istendiğinde içeriğe eriştiğinden LLM'nin Google Haritalar Platformu ile ilgili bağlamı, modelin eğitim tarihinde mevcut verilerle sınırlı olmak zorunda değildir.

MCP sunucusunun erişebileceği Google Haritalar Platformu kaynakları şunlardır:

  • Google Haritalar Platformu Belgeleri
  • Google Haritalar Platformu Hizmet Şartları
  • Google Haritalar Platformu Güven Merkezi
  • Google Haritalar Platformu'nun resmi GitHub kuruluşlarındaki kod depoları

Geliştiriciler

  • 🪄 En sevdiğiniz yapay zeka asistanını veya IDE'yi Google Haritalar Platformu uzmanı yapın. Code Assist ile Gemini CLI, Claude Code ve Cursor gibi yapay zeka temsilcileri, güncel ve resmi Google Haritalar Platformu dokümanlarına ve kod örneklerine dayalı olarak doğrudan geliştirme iş akışınızda kod oluşturabilir ve geliştiricilerin sorularını yanıtlayabilir.

  • 🚀 İster yapay zeka destekli hassas kod değişiklikleri yapıyor olun ister yeni bir uygulama prototipi için vibe coding yapın, Code Assist görevinizi daha hızlı ve kolay bir şekilde tamamlamanıza yardımcı olabilir.

🔧 Sağlanan Araçlar

MCP sunucusu, yapay zeka istemcileri için aşağıdaki araçları kullanıma sunar:

  1. retrieve-instructions: Müşterinin, kullanıcı amacını en iyi şekilde anlama ve retrieve-google-maps-platform-docs aracına etkili çağrılar oluşturma konusunda önemli sistem talimatları almasına yardımcı olan bir araç.
  2. retrieve-google-maps-platform-docs: Birincil araç. Doğal dil sorgusunu alıp barındırılan bir Almayla Artırılmış Üretim (RAG) motoruna gönderir. RAG motoru, resmi Google Haritalar Platformu dokümanlarının, eğitimlerinin ve kod örneklerinin güncel sürümlerini arar. Doğru bir yanıt oluşturması için yapay zekaya alakalı bağlamı döndürür.

🛠️ Desteklenen MCP Aktarımları

Bu sunucu iki standart MCP iletişim protokolünü destekler:

  • stdio: Bu, bir istemci sunucuyu command üzerinden çağırdığında kullanılan varsayılan aktarımdır. Standart giriş/çıkış akışları üzerinden iletişim kurduğu için yerel komut satırı yürütme için idealdir.
  • Streamable HTTP: Sunucu, POST isteklerini kabul eden bir /mcp uç noktası sunar. Bu, url üzerinden bağlanan istemciler tarafından kullanılır ve uzak sunucu bağlantıları için standarttır. Uygulamamız, anlık ve etkileşimli yanıtlar için akışı destekler.

🚀 Kullanım

Code Assist MCP sunucusunu yerel geliştirme makinenizde veya Google Cloud Run'da uzaktan çalıştırabilirsiniz.

Şartlar

Google Haritalar Platformu Code Assist araç setini kullanmak için sunucuyu klonlayıp çalıştırmak üzere Node.js (LTS sürümü önerilir) ve npm'nin yüklü olduğu bir ortamın yanı sıra sunucuya erişmek için bir MCP istemcisi gerekir.

Sunucuyu yerel makinenizde çalıştırın ve istemcileri, yapay zeka destekli IDE'lerle (ör. VS Code, Android Studio, Cursor) veya masaüstü yapay zeka uygulamalarıyla (ör. Gemini CLI) kullanılmak üzere stdio protokolünü kullanarak bağlayın. Bu, en basit ve en yaygın kurulumdur.

İstemcinizi Yapılandırma

Sunucuyu tercih ettiğiniz yapay zeka istemcisinin MCP yapılandırma dosyasına ekleyin. Doğrulanmış talimatlar için aşağıda müşterinizi bulun.

  1. Gemini Code Assist ve Gemini CLI

    • 1. seçenek: Sunucuyu doğrudan komut satırınızdan ekleyin (Gemini CLI'nın zaten yüklü olduğunu varsayarak): 
       gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
      • gemini mcp list komutunu çalıştırarak yüklemeyi doğrulayın.
    • 2. seçenek: MCP sunucu yapılandırmasını ~/.gemini/settings.json dosyanıza manuel olarak ekleyin.
    {
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}

  2. Claude Code

    • 1. seçenek: Sunucuyu doğrudan komut satırınızdan ekleyin (Claude Code'un zaten yüklü olduğunu varsayarak): 
          claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist@latest
      • claude mcp list komutunu çalıştırarak yüklemeyi doğrulayın.
      • Windows kullanıcıları: Yerel Windows'da (WSL değil) npx komutlarının doğru çalışması için cmd /c sarmalayıcısını kullanmanız gerekir.
      claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
    • 2. seçenek: Sunucuyu Claude yapılandırma dosyanıza manuel olarak ekleme ~/.claude.json
    "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": [
        "-y", "@googlemaps/code-assist-mc@latest"
      ]
    }
  }

  3. İmleç

    • MCP sunucusunu yükleme <-- Cursor'ı yüklediyseniz Google Haritalar Platformu Code Assist MCP'yi doğrudan yüklemek için burayı tıklayın.
    • Aksi takdirde, çalışma alanınızın .cursor-settings/mcp.json dosyasına ekleyin.
    {
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}

  4. Firebase Studio

    • Code Assist MCP'nin yüklü olduğu Firebase Studio&#39;da deneyin
    • Firebase Studio çalışma alanınızdaki .idx klasöründe bulunan projenizin mcp.json dosyasına ekleyin.
    {
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}

  5. Android Studio

    • Bir mcp.json dosyası oluşturun ve Android Studio'nun yapılandırma dizinine yerleştirin. Code Assist sunucusunu listeye ekleyin:
    {
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}

  6. Cline

    • 1. seçenek: Cline MCP GUI'yi kullanarak yükleme
    • 2. seçenek: Cline MCP yapılandırma dosyasını kullanarak manuel / programatik olarak yükleme. Yapılandırma dosyası şu konumda bulunur:
      • 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
      • cline_mcp_settings.json bölümündeki MCP yapılandırmanıza aşağıdakileri ekleyin: 
        {
  "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

    • 1. seçenek: Roo MCP GUI'yi kullanarak yükleme
    • 2. seçenek: Roo Code yapılandırma dosyasını kullanarak manuel olarak / programatik olarak yükleyin. Yapılandırma dosyası şu konumda bulunur:
      • 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_settings.json bölümündeki MCP yapılandırmanıza aşağıdakileri ekleyin: 
        {
  "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

    • Aracı modundayken "Araçlar"ı, ardından üst başlıktaki "Araçları Yapılandır"ı ve "NPM paket adından yükle"yi tıklayın (Aşağıdaki ekran görüntülerini inceleyin).

    • resim
    • resim
    • resim

    • Paket adını @googlemaps/code-assist-mcp girip ENTER tuşuna basın. Yüklemeyi kabul edip varsayılan 3000 bağlantı noktasını kullanın. Ardından, değişikliği onaylamak için son kez ENTER tuşuna basın.

    • resim

  9. Windsurf

    • Yukarıdaki imleç talimatlarına benzer.

  10. Kilo Code

    • Yukarıdaki Cline ve Roo Kodu talimatlarına benzer

Daha fazla bilgi

Araç kitini yükleme ve kullanma ile kullanım şartları hakkında daha fazla bilgi için GitHub deposundaki README dosyasına bakın.