Google Maps Platform का कोड असिस्ट टूलकिट

ब्यौरा

Google Maps Platform Code Assist टूलकिट, मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर है. यह Google Maps Platform के साथ ऐप्लिकेशन डेवलप करने के लिए इस्तेमाल किए जाने वाले लार्ज लैंग्वेज मॉडल (एलएलएम) से मिलने वाले जवाबों को बेहतर बनाता है. इसके लिए, यह आधिकारिक, अप-टू-डेट दस्तावेज़ और कोड सैंपल में मौजूद जानकारी का इस्तेमाल करता है.

मॉडल को प्रॉम्प्ट मिलने पर, एमसीपी सर्वर कॉन्टेंट ऐक्सेस करता है. इसलिए, Google Maps Platform के बारे में एलएलएम का कॉन्टेक्स्ट, मॉडल की ट्रेनिंग की तारीख के हिसाब से उपलब्ध डेटा तक सीमित नहीं होना चाहिए.

एमसीपी सर्वर, Google Maps Platform के इन संसाधनों को ऐक्सेस कर सकता है:

  • Google Maps Platform के दस्तावेज़
  • Google Maps Platform की सेवा की शर्तें
  • Google Maps Platform का भरोसा केंद्र
  • Google Maps Platform के आधिकारिक GitHub संगठनों में कोड रिपॉज़िटरी

उपलब्ध टूल

एमसीपी सर्वर, एआई क्लाइंट के लिए ये टूल उपलब्ध कराता है:

  1. retrieve-instructions: यह एक हेल्पर टूल है. इसका इस्तेमाल क्लाइंट, सिस्टम से जुड़ी ज़रूरी जानकारी पाने के लिए करता है. इस जानकारी से, क्लाइंट को यह समझने में मदद मिलती है कि उपयोगकर्ता का मकसद क्या है. साथ ही, वह retrieve-google-maps-platform-docs टूल को बेहतर तरीके से कॉल कर पाता है.
  2. retrieve-google-maps-platform-docs: यह मुख्य टूल है. यह आम भाषा में की गई क्वेरी लेता है और इसे होस्ट किए गए Retrieval Augmented Generation (RAG) इंजन को सबमिट करता है. आरएजी इंजन, Google Maps Platform के आधिकारिक दस्तावेज़, ट्यूटोरियल, और कोड सैंपल के नए वर्शन खोजता है. इसके बाद, एआई को सही जवाब जनरेट करने के लिए ज़रूरी कॉन्टेक्स्ट देता है.

एमसीपी ट्रांसपोर्ट की सुविधा

यह सर्वर, एमसीपी के दो स्टैंडर्ड कम्यूनिकेशन प्रोटोकॉल के साथ काम करता है:

  • stdio: जब कोई क्लाइंट, command के ज़रिए सर्वर को शुरू करता है, तब इस डिफ़ॉल्ट ट्रांसपोर्ट का इस्तेमाल किया जाता है. यह स्टैंडर्ड इनपुट/आउटपुट स्ट्रीम पर कम्यूनिकेट करता है. इसलिए, यह कमांड-लाइन को स्थानीय तौर पर एक्ज़ीक्यूट करने के लिए सबसे सही है.
  • Streamable HTTP: सर्वर, /mcp एंडपॉइंट को दिखाता है. यह एंडपॉइंट, POST अनुरोधों को स्वीकार करता है. इसका इस्तेमाल उन क्लाइंट के लिए किया जाता है जो url के ज़रिए कनेक्ट होते हैं. साथ ही, यह रिमोट सर्वर कनेक्शन के लिए स्टैंडर्ड है. हमारा इंटिग्रेशन, रीयल-टाइम में इंटरैक्टिव जवाब पाने के लिए स्ट्रीमिंग की सुविधा देता है.

इस्तेमाल

Code Assist के एमसीपी सर्वर को, अपनी लोकल डेवलपमेंट मशीन पर या Google Cloud Run पर रिमोटली चलाया जा सकता है.

ज़रूरी शर्तें

Google Maps Platform Code Assist टूलकिट का इस्तेमाल करने के लिए, आपको ऐसे एनवायरमेंट की ज़रूरत होगी जिसमें Node.js (एलटीएस वर्शन का सुझाव दिया जाता है) और npm इंस्टॉल हो. ऐसा सर्वर को क्लोन करने और चलाने के लिए ज़रूरी है. साथ ही, सर्वर को ऐक्सेस करने के लिए, आपको MCP क्लाइंट की भी ज़रूरत होगी.

सर्वर को अपनी लोकल मशीन पर चलाएं और क्लाइंट को stdio प्रोटोकॉल का इस्तेमाल करके कनेक्ट करें. ऐसा एआई की मदद से काम करने वाले IDE (जैसे, VS Code, Android Studio, Cursor) या डेस्कटॉप एआई ऐप्लिकेशन (जैसे, Gemini CLI) के साथ इस्तेमाल करने के लिए करें. यह सबसे आसान और सामान्य सेटअप है.

अपने क्लाइंट को कॉन्फ़िगर करना

अपने पसंदीदा एआई क्लाइंट की एमसीपी कॉन्फ़िगरेशन फ़ाइल में सर्वर जोड़ें. पुष्टि किए गए खास निर्देशों के लिए, यहां दिए गए क्लाइंट को ढूंढें.

  1. Gemini Code Assist और Gemini CLI

    • पहला विकल्प - सीधे अपनी कमांड लाइन से सर्वर जोड़ें. इसके लिए, यह मान लिया जाता है कि आपने Gemini CLI पहले से ही इंस्टॉल कर लिया है:
       gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
      
      • gemini mcp list चलाकर, इंस्टॉलेशन की पुष्टि करें.
    • दूसरा विकल्प - Code Assist MCP सर्वर को Gemini CLI एक्सटेंशन के तौर पर इंस्टॉल करें:
      gemini extensions install https://github.com/googlemaps/platform-ai.git
      
    • तीसरा विकल्प - एमसीपी सर्वर के कॉन्फ़िगरेशन को अपनी ~/.gemini/settings.json फ़ाइल में मैन्युअल तरीके से जोड़ें.
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  2. Claude Code

    • पहला विकल्प - सर्वर को सीधे अपनी कमांड लाइन से जोड़ें. इसके लिए, यह ज़रूरी है कि आपने Claude Code पहले से इंस्टॉल किया हो:
          claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
      
      • claude mcp list चलाकर, इंस्टॉलेशन की पुष्टि करें.
      • Windows का इस्तेमाल करने वाले लोग: WSL के बजाय, Windows के नेटिव वर्शन पर 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"
          ]
        }
      }
    
  3. कर्सर

    • एमसीपी सर्वर इंस्टॉल करना <-- If you already have Cursor installed, click here to install Google Maps Platform Code Assist MCP directly.
    • अगर ऐसा नहीं है, तो इसे अपने फ़ाइल फ़ोल्डर की .cursor-settings/mcp.json फ़ाइल में जोड़ें.
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  4. Firebase Studio

    • Firebase Studio में आज़माएं जिसमें Code Assist MCP इंस्टॉल हो
    • अपने प्रोजेक्ट की mcp.json फ़ाइल को Firebase Studio के फ़ाइल फ़ोल्डर में मौजूद .idx फ़ोल्डर में जोड़ें
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  5. Android Studio

    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  6. Cline

    • पहला विकल्प: Cline MCP GUI का इस्तेमाल करके इंस्टॉल करना
    • दूसरा विकल्प: 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
      • 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

    • पहला विकल्प: Roo MCP GUI का इस्तेमाल करके इंस्टॉल करना
    • दूसरा विकल्प: 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_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

    • एजेंट मोड में, "टूल" पर क्लिक करें. इसके बाद, सबसे ऊपर मौजूद हेडर में "टूल कॉन्फ़िगर करें" और फिर "एनपीएम पैकेज के नाम से इंस्टॉल करें" पर क्लिक करें (नीचे दिए गए स्क्रीनशॉट देखें)

    • इमेज
    • इमेज
    • इमेज
    • पैकेज का नाम @googlemaps/code-assist-mcp डालें और ENTER दबाएं. इसके बाद, इंस्टॉल करने की अनुमति दें और डिफ़ॉल्ट पोर्ट 3000 का इस्तेमाल करें. बदलाव की पुष्टि करने के लिए, आखिरी बार ENTER दबाएं

    • इमेज
  9. विंडसर्फ़

    • ऊपर दिए गए कर्सर के निर्देशों की तरह ही.
  10. किलो कोड

    • ऊपर दिए गए, क्लाइन और रू कोड से जुड़े निर्देशों की तरह

ज़्यादा जानें

टूलकिट को इंस्टॉल करने और इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, GitHub रिपॉज़िटरी का README देखें. साथ ही, इस्तेमाल की शर्तें भी देखें.