关键词

地图开发AI辅助文档检索RAGGoogle Maps Platform

项目简介

Google Maps Platform AI 辅助服务器（Google Maps Platform Code Assist toolkit）是一个基于Model Context Protocol (MCP) 构建的后端服务。它的核心目标是帮助开发人员在使用大型语言模型（LLM）开发Google Maps Platform应用时，提供官方、最新、准确的文档、代码示例及最佳实践，以增强LLM的响应质量和相关性。它通过托管资源（如使用说明）、注册工具（如文档检索）以及处理LLM客户端的请求来实现这一目标。

主要功能点

  • Google Maps Platform文档检索: 允许LLM通过工具调用检索Google Maps Platform的官方文档、代码示例、架构中心、GitHub仓库等信息。
  • 关键指令与上下文提供: 托管并提供重要的系统指令和上下文信息，确保LLM在使用其他工具前获得必要的基础知识。
  • MCP协议支持: 完全遵循Model Context Protocol，支持JSON-RPC请求和响应，通过Stdio和Streamable HTTP（支持SSE）进行通信。
  • 会话管理与能力声明: 为每个客户端会话提供独立的上下文，并声明其支持的工具和资源能力。
  • 安全与合规: 实现Origin头部验证、Accept头部验证以及结构化错误响应，以确保安全通信和协议合规性。

安装步骤

该服务器是一个Node.js应用。您需要Node.js环境来运行它。

  1. 克隆仓库: 'git clone https://github.com/googlemaps/platform-ai.git'
  2. 进入目录: 'cd platform-ai/packages/code-assist'
  3. 安装依赖: 'npm install' 或 'yarn install'
  4. 运行服务器: 'npm start' (默认启动HTTP服务器在3000端口，同时启动Stdio服务器) 您也可以通过 '--port' 参数指定端口，例如 'npm start -- --port 8080'。 对于生产环境，建议设置 'NODE_ENV=production' 和 'ALLOWED_ORIGINS' 环境变量来配置允许的客户端来源。

服务器配置

MCP客户端需要以下信息来连接到此服务器：

{
  "name": "Google Maps Platform AI 辅助服务器",
  "command": "node", // 用于启动服务器的可执行文件
  "args": [
    "/path/to/platform-ai/packages/code-assist/index.js", // 服务器主入口文件，请替换为实际的仓库路径
    "--port", "3000" // MCP服务器监听的HTTP端口，请确保与服务器实际启动的端口一致
  ],
  "transports": [
    {
      "type": "stdio"
    },
    {
      "type": "http",
      "url": "http://localhost:3000/mcp" // MCP HTTP端点，确保端口匹配服务器实际监听的端口
    }
  ]
}

基本使用方法

一旦服务器运行并通过MCP客户端连接，LLM即可：

  1. 加载关键指令: 在任何查询之前，建议LLM加载名为 'instructions' 的资源（URI为 'mcp://google-maps-platform-code-assist/instructions'），或调用名为 'retrieve-instructions' 的工具，以获取关于Google Maps Platform的基础上下文和使用最佳实践。
  2. 检索文档: 调用名为 'retrieve-google-maps-platform-docs' 的工具，并提供 'prompt' 参数（用户的问题）和可选的 'search_context' 参数（补充上下文），服务器将利用内部RAG服务返回相关的Google Maps Platform文档内容。

信息

分类

开发者工具

访问项目