Baidu Map MCP Server for Cursor: Setup & Config

What you can do with Baidu Map in Cursor

A single Baidu Maps bridge for routes, places, weather, traffic, and address conversion.

• Add current traffic conditions to navigation recommendations.
• Extract places from travel notes when advanced permissions are available.

Before you start: Baidu Map in Cursor

• Node.js and npx for this launch option
• A Baidu Maps server-side API key
• An MCP-compatible client

This is the README's Node.js configuration. Its Python alternative uses python -m mcp_server_baidu_maps and BAIDU_MAPS_API_KEY instead. SSE is recommended in the README, but no direct SSE server URL is provided in the supplied text. Advanced POI extraction requires extra permission.

Baidu Map Cursor configuration

1. Choose Cursor configuration scope

   For Baidu Map MCP Server, open Project: .cursor/mcp.json User: ~/.cursor/mcp.json. Merge into mcpServers at project or user scope.

2. Add Baidu Map MCP Server to Cursor

   Use the mcp-baidu-maps entry below in mcpServers. Keep Baidu Map MCP Server's documented stdio connection fields and your other Cursor entries.

3. Check Baidu Map MCP Server in Cursor

   Baidu Map MCP Server: Enable in Cursor’s MCP settings; inspect tools.

{
  "mcpServers": {
    "mcp-baidu-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@baidumap/mcp-server-baidu-map"
      ],
      "env": {
        "BAIDU_MAP_API_KEY": "<Baidu Maps server-side API key>"
      }
    }
  }
}

Baidu Map tools available to Cursor

Baidu Map's stored tool list documents 11 tools; compare it with Cursor's connected tool list, because the stored list is not a live check.

map_geocode

Find map_geocode under Baidu Map in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Resolve an address into geographic coordinates.

map_reverse_geocode

Find map_reverse_geocode under Baidu Map in Cursor's MCP settings; inspect its arguments when the agent requests a call.

map_search_places

Find map_search_places under Baidu Map in Cursor's MCP settings; inspect its arguments when the agent requests a call.

map_place_details

Find map_place_details under Baidu Map in Cursor's MCP settings; inspect its arguments when the agent requests a call.

map_distance_matrix

Find map_distance_matrix under Baidu Map in Cursor's MCP settings; inspect its arguments when the agent requests a call.

map_directions

Find map_directions under Baidu Map in Cursor's MCP settings; inspect its arguments when the agent requests a call.

map_weather

Find map_weather under Baidu Map in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Get current weather and a five-day forecast using a region code or coordinates.

map_ip_location

Find map_ip_location under Baidu Map in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Look up geographic location from an IP address.

map_road_traffic

Find map_road_traffic under Baidu Map in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Inspect current road congestion, affected segments, distances, and trends.

map_poi_extract

Find map_poi_extract under Baidu Map in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Identify places in free text; advanced permission is required.

map_directions_matrix

Find map_directions_matrix under Baidu Map in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Batch route planning for driving, walking, or cycling; the matrix tool name shown in the README.

Baidu Map: full stored tool descriptions

Troubleshooting Baidu Map in Cursor

• Cursor must find npx @baidumap/mcp-server-baidu-map (Node.js/npm) for Baidu Map MCP Server. Enable the project/user entry in MCP settings and inspect its tools.
• Review BAIDU_MAP_API_KEY for Baidu Map MCP Server before sharing project .cursor/mcp.json; project scope travels with the repository.
• Baidu Map MCP Server uses stdio here: Cursor must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Requires a Baidu Maps server-side API key.
• Known limitation: Text-to-place extraction needs advanced permission.
• Known limitation: The input sources use different names for the route-matrix tool.
• General Cursor troubleshooting lives in the /clients/cursor guide.

Frequently asked questions