Bộ công cụ Hỗ trợ mã của Nền tảng Google Maps

Mô tả

Bộ công cụ Hỗ trợ mã của Google Maps Platform là một máy chủ Giao thức ngữ cảnh mô hình (MCP) giúp cải thiện các phản hồi từ các mô hình ngôn ngữ lớn (LLM) được dùng để phát triển các ứng dụng bằng Google Maps Platform bằng cách đặt cơ sở cho các phản hồi trong tài liệu và mẫu mã chính thức, mới nhất.

Vì máy chủ MCP truy cập vào nội dung khi mô hình được nhắc, nên ngữ cảnh của LLM liên quan đến Google Maps Platform không bị giới hạn ở dữ liệu có sẵn tại ngày huấn luyện mô hình.

Các tài nguyên của Nền tảng Google Maps mà máy chủ MCP có thể truy cập bao gồm:

• Tài liệu về Nền tảng Google Maps
• Điều khoản dịch vụ của Nền tảng Google Maps
• Trung tâm tin cậy của Nền tảng Google Maps
• Kho lưu trữ mã trong các tổ chức chính thức của Nền tảng Google Maps trên GitHub

Nhà phát triển

• 🪄 Biến trợ lý AI hoặc IDE mà bạn yêu thích thành chuyên gia về Nền tảng Google Maps. Với Trợ lý lập trình, các tác nhân AI như Gemini CLI, Claude Code và Cursor có thể tạo mã và trả lời các câu hỏi của nhà phát triển dựa trên tài liệu và mẫu mã chính thức, mới nhất của Google Maps Platform – ngay trong quy trình phát triển của bạn.

• 🚀 Cho dù bạn đang thực hiện các thay đổi về mã có độ chính xác cao nhờ sự hỗ trợ của AI hay đang tạo nguyên mẫu ứng dụng mới, thì Trợ lý lập trình đều có thể giúp bạn hoàn thành nhiệm vụ nhanh chóng và dễ dàng hơn.

🔧 Cung cấp công cụ

Máy chủ MCP cung cấp các công cụ sau cho ứng dụng AI:

1. retrieve-instructions: Một công cụ trợ giúp mà ứng dụng sử dụng để nhận được các chỉ dẫn quan trọng của hệ thống về cách suy luận tốt nhất về ý định của người dùng và đưa ra các lệnh gọi hiệu quả cho công cụ retrieve-google-maps-platform-docs.
2. retrieve-google-maps-platform-docs: Công cụ chính. Công cụ này nhận một truy vấn bằng ngôn ngữ tự nhiên và gửi truy vấn đó đến một công cụ Tạo sinh tăng cường truy xuất (RAG) được lưu trữ. Công cụ RAG tìm kiếm các phiên bản mới nhất của tài liệu, hướng dẫn và mẫu mã chính thức của Google Maps Platform, trả về ngữ cảnh có liên quan cho AI để tạo ra câu trả lời chính xác.

🛠️ Các phương thức truyền tải MCP được hỗ trợ

Máy chủ này hỗ trợ 2 giao thức giao tiếp MCP tiêu chuẩn:

• stdio: Đây là phương thức truyền tải mặc định được dùng khi một ứng dụng gọi máy chủ thông qua command. Nó giao tiếp qua các luồng đầu vào/đầu ra tiêu chuẩn, khiến nó trở nên lý tưởng cho việc thực thi dòng lệnh cục bộ.
• Streamable HTTP: Máy chủ hiển thị một điểm cuối /mcp chấp nhận các yêu cầu POST. Đây là tiêu chuẩn được dùng cho các ứng dụng kết nối thông qua url và là tiêu chuẩn cho các kết nối máy chủ từ xa. Quy trình triển khai của chúng tôi hỗ trợ truyền phát trực tiếp để đưa ra các phản hồi mang tính tương tác theo thời gian thực.

🚀 Mức sử dụng

Bạn có thể chạy máy chủ MCP của Trợ lý lập trình trên máy phát triển cục bộ hoặc từ xa trên Google Cloud Run.

Yêu cầu

Để sử dụng bộ công cụ Hỗ trợ mã của Google Maps Platform, bạn cần có một môi trường có cài đặt Node.js (nên dùng phiên bản LTS) và npm để sao chép và chạy máy chủ, cũng như một ứng dụng MCP để truy cập vào máy chủ.

Sử dụng Trợ lý mã làm Máy chủ MCP cục bộ với phương thức truyền stdio (Nên dùng)

Chạy máy chủ trên máy cục bộ và kết nối các máy khách bằng giao thức stdio để sử dụng với các IDE có sự hỗ trợ của AI (chẳng hạn như VS Code, Android Studio, Cursor) hoặc các ứng dụng AI trên máy tính (chẳng hạn như Gemini CLI). Đây là chế độ thiết lập đơn giản và phổ biến nhất.

Định cấu hình ứng dụng

Thêm máy chủ vào tệp cấu hình MCP của ứng dụng AI mà bạn muốn. Hãy tìm ứng dụng khách của bạn bên dưới để xem hướng dẫn cụ thể và đã được xác minh.

1. Gemini Code Assist và Gemini CLI

   • Cách 1 – Thêm máy chủ trực tiếp từ dòng lệnh (giả sử bạn đã cài đặt Gemini CLI):

      gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
     

     • Xác minh quá trình cài đặt bằng cách chạy gemini mcp list.
   • Cách 2 – Thêm cấu hình máy chủ MCP theo cách thủ công vào tệp ~/.gemini/settings.json.

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

2. Claude Code

   • Cách 1 – Thêm máy chủ ngay từ dòng lệnh (giả sử bạn đã cài đặt Claude Code):

         claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist@latest
     

     • Xác minh quá trình cài đặt bằng cách chạy claude mcp list.
     • Người dùng Windows: Trên Windows gốc (không phải WSL), bạn phải sử dụng trình bao bọc cmd /c để các lệnh npx hoạt động chính xác.

     claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
     

   • Cách 2 – Thêm máy chủ theo cách thủ công vào tệp cấu hình Claude ~/.claude.json

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

3. Cursor

   • <-- If you already have Cursor installed, click here to install Google Maps Platform Code Assist MCP directly.
   • Nếu không, hãy thêm tệp này vào tệp .cursor-settings/mcp.json của không gian làm việc.

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

4. Firebase Studio

   • khi đã cài đặt MCP Code Assist
   • Thêm vào tệp mcp.json của dự án trong thư mục .idx trong không gian làm việc Firebase Studio

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

5. Android Studio

   • Tạo một tệp mcp.json rồi đặt tệp đó vào thư mục cấu hình của Android Studio. Thêm máy chủ Hỗ trợ mã vào danh sách:

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

6. Cline

   • Cách 1: cài đặt bằng Cline MCP GUI
   • Cách 2: cài đặt theo cách thủ công / theo chương trình bằng tệp cấu hình Cline MCP. Tệp cấu hình nằm ở:
     • 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
     • Thêm nội dung sau vào cấu hình MCP trong 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

   • Cách 1: cài đặt bằng Roo MCP GUI
   • Cách 2: cài đặt theo cách thủ công / theo chương trình bằng tệp cấu hình Roo Code. Tệp cấu hình nằm ở:
     • 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
     • Thêm nội dung sau vào cấu hình MCP trong 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

   • Khi ở chế độ Agent, hãy nhấp vào "Tools" (Công cụ), sau đó trong tiêu đề trên cùng, hãy nhấp vào "Configure Tools" (Định cấu hình công cụ), rồi nhấp vào "Install from an NPM package name" (Cài đặt từ tên gói NPM) (Xem ảnh chụp màn hình bên dưới)

   • 
   • 
   • 

   • Nhập tên gói @googlemaps/code-assist-mcp rồi nhấn ENTER, chấp nhận quá trình cài đặt và sử dụng cổng mặc định 3000, sau đó nhấn ENTER một lần nữa để xác nhận thay đổi

   • 

9. Lướt ván buồm

   • Tương tự như hướng dẫn về Cursor ở trên.

10. Kilo Code

    • Tương tự như hướng dẫn về Mã Cline và Roo ở trên

Tìm hiểu thêm

Để biết thêm thông tin về cách cài đặt và sử dụng bộ công cụ, cũng như các điều khoản sử dụng, hãy xem tệp README trong kho lưu trữ GitHub.