使用说明

本项目为百度地图 MCP Server，旨在为 LLM 应用提供基于 MCP 协议的地图服务能力。通过本服务，LLM 可以调用百度地图的地理编码、逆地理编码、地点检索、路线规划等工具，从而实现与地图相关的智能交互。

主要功能点：

地理编码: 将地址转换为经纬度坐标。
逆地理编码: 将经纬度坐标转换为地址描述。
地点检索: 根据关键词和区域检索地点信息，例如搜索附近的餐厅、酒店等。
地点详情检索: 获取指定地点的详细信息，例如评分、营业时间等。
批量算路: 批量计算多个起点到多个终点的路线距离和时间，适用于需要比较不同路线方案的场景。
路线规划: 规划驾车、步行、骑行、公交等多种出行方式的详细路线，并提供路线步骤和预计耗时。
天气查询: 查询指定地区或城市当前的天气信息。
IP 定位: 根据用户 IP 地址获取其所在城市的位置信息。

安装步骤 (Python)：

安装 Python 环境: 确保已安装 Python 3.11 或更高版本。
安装 uv 包管理工具: 按照 MCP 官方文档安装 'uv' 包管理工具。'uv' 是一个快速的 Python 包安装和依赖管理工具，可以简化环境搭建过程。
添加 mcp 依赖: 在命令行中，进入你希望创建项目的目录，并运行命令 'uv add "mcp[cli]"'。这将使用 'uv' 添加 'mcp[cli]' 依赖，'mcp[cli]' 包含了运行 MCP Server 所需的命令行工具和库。
安装 Python 3.11: 如果你的环境中没有 Python 3.11，运行 'uv python install 3.11' 安装指定版本的 Python。
获取 MCP Server 代码: 访问 GitHub 仓库下载 'map.py' 文件。这是百度地图 MCP Server 的 Python 代码实现。
创建项目目录: 使用 'uv init baidu_map_mcp_server' 命令创建一个名为 'baidu_map_mcp_server' 的项目目录。这将初始化一个新的 Python 项目，并使用 'uv' 进行管理。
拷贝 map.py: 将下载的 'map.py' 文件拷贝到刚刚创建的 'baidu_map_mcp_server' 目录下。
启动 MCP Server: 打开命令行终端，进入 'baidu_map_mcp_server' 目录，运行命令 'uv run --with mcp[cli] mcp run map.py' 启动 MCP Server。确保在运行前已设置环境变量 'BAIDU_MAPS_API_KEY'，用于配置你的百度地图 API 密钥。

MCP 客户端配置 (JSON 示例，以 Cursor 为例):

以下 JSON 配置示例用于配置 Cursor 客户端连接到百度地图 MCP Server。你需要将此配置添加到 Cursor 的 MCP Server 设置中。

{
  "mcpServers": {
    "baidu-map": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "{您的项目路径}/baidu_map_mcp_server/map.py"  // 请将 "{您的项目路径}" 替换为 map.py 文件所在的实际项目路径。例如："/Users/username/baidu_map_mcp_server/map.py"
      ],
      "env": {
        "BAIDU_MAPS_API_KEY": "{您的百度地图API密钥}"  // 请将 "{您的百度地图API密钥}" 替换为你在百度地图开放平台申请的 API 密钥 (AK)。
      }
    }
  }
}

基本使用方法：

获取百度地图 API 密钥 (AK): 访问百度地图开放平台创建服务端应用，并获取用于服务端 API 调用的 AK (API 密钥)。请确保选择正确的应用类型和服务，并启用所需的相关 API 服务。
配置 MCP 客户端: 在支持 MCP 协议的 LLM 客户端 (如 Cursor, Claude, 千帆 AppBuilder) 中，找到 MCP Server 配置选项，根据上述 JSON 示例添加或修改配置。确保将路径和 API 密钥替换为你自己的实际信息。
在 LLM 中使用地图工具: 配置完成后，在 LLM 对话中，你可以使用自然语言指令来调用百度地图提供的工具。例如，你可以提问 "北京今天天气怎么样？" 或 "从天安门到故宫怎么坐公交？"，LLM 将通过 MCP Server 调用相应的百度地图工具来获取答案并返回给你。

注意： 启动 MCP Server 前，请务必设置名为 'BAIDU_MAPS_API_KEY' 的环境变量，并将你的百度地图 API 密钥 (AK) 设置为该环境变量的值。这可以通过命令行 export 命令 (Linux/macOS) 或 set 命令 (Windows) 设置，也可以在操作系统或 IDE 的环境变量配置中进行设置。

关键词

信息