Google Maps MCP 服务器

该项目提供了一个基于Python的模型上下文协议（MCP）服务器，利用Google Maps和Places API来回答关于印度本地商家和旅游景点的问题。它旨在帮助用户和开发者通过简单的MCP接口轻松检索诸如“班加罗尔最好的咖啡馆是什么？”或“海得拉附近最受欢迎的旅游景点”之类的信息。

特性

• 查询Google Maps以获取地点、餐馆、旅游景点等信息
• 使用自己的Google Maps API密钥进行简单配置
• 模块化、可维护且可测试的代码库
• 准备扩展和贡献

开始使用

预备条件

• Python 3.8+
• 一个Google Maps API密钥（在这里获取）

运行MCP服务器

• 使用以下命令安装uvx

curl -LsSf https://astral.sh/uv/install.sh | sh

• 运行MCP服务器

uvx google-mcp-server

贡献

• 分叉此仓库并创建一个特性分支。
• 为您的更改添加或更新测试。
• 提交一个清晰描述您更改的拉取请求。

设置步骤

• 克隆仓库：

  git clone <your-fork-url>
  cd google_maps_mcp
  

• 构建： 到项目根目录并运行

  uv build
  

• 设置您的Google Maps API密钥：

  • 您可以在环境变量中设置，也可以在配置中设置（见下文）。
  • 示例（Linux/macOS）：

    export GOOGLE_MAPS_API_KEY=your_api_key_here
    

• 安装本地构建作为可执行文件： 确保您的PATH环境变量包含~/.local/bin路径。

  如果没有，请将以下内容添加到您的~/.bashrc文件末尾。

  export PATH=$PATH:~/.local/bin
  

  然后运行

  source ~/.bashrc
  

6. 运行包含MCP服务器的可执行文件：

   uvx dist/google_maps_mcp-1.0.0-py3-none-any.whl
   

Visual Studio Code: MCP服务器配置示例

"mcp": {
        "servers": {
            "google_maps_mcp_server":{
                "type": "stdio",
                "command": "uvx",
                "args": ["google-maps-mcp"],
                "env": {
                    "GOOGLE_MAPS_API_KEY": "<your google maps API key>"
                }
            }
        }
    }