Baidu Map MCP Server

What is Baidu Map MCP Server about?

A fully MCP‑compliant, open‑source location‑based service that delivers geocoding, reverse geocoding, POI search, batch and single‑point routing, weather forecasts, real‑time traffic, IP‑based location, and advanced POI extraction. It bridges large language models and AI agents with authoritative Baidu Maps data via standardized MCP tools.

How to use Baidu Map MCP Server?

Obtain an API Key – Register on Baidu Maps Open Platform and enable the “MCP (SSE)” service.
Install the SDK –
- Python: pip install mcp-server-baidu-maps
- Node/TypeScript: npm install @baidumap/mcp-server-baidu-map
Run the server –
- Python: python -m mcp_server_baidu_maps
- Node (recommended): npx -y @baidumap/mcp-server-baidu-map
Configure the MCP client – Add a server entry with the command, args, and the API key environment variable.
Call tools – Use tool names such as map_geocode, map_directions, map_weather, etc., from any MCP‑compatible client, LLM, or agent.

Key Features

Full MCP protocol support for any MCP‑compliant agent or platform.
Rich LBS capabilities: geocoding, reverse geocoding, POI search/details, multi‑mode routing, traffic, weather, IP location.
Cross‑platform SDKs (Python, TypeScript) and CLI execution.
Low‑latency Server‑Sent Events (SSE) access.
Open‑source MIT license, easy to extend and customize.
Powered by Baidu’s authoritative, up‑to‑date map data.

Use Cases

Travel Assistant – Combine map_search_places, map_directions, and map_weather to suggest itineraries, recommend attractions, and provide weather‑aware routes.
Logistics Optimization – Use map_directions_matrix for batch route calculations, delivering cost‑effective delivery schedules.
Smart City Dashboards – Merge map_road_traffic and map_weather for real‑time traffic‑aware navigation services.
AI‑Driven Conversational Agents – Enable LLMs to answer location queries, extract POIs from free text (map_poi_extract), and perform context‑aware planning.
IP‑Based Geo‑Targeting – Resolve user IPs to city‑level locations for personalized content.

FAQ

Do I need a Baidu Maps account? Yes, an API key from the Baidu Maps Open Platform is required.
Which Python versions are supported? Python 3.10 – 3.12.
Can I run the server locally? Yes, the SDKs can be started on any machine with the required runtime.
What is the recommended access method? Server‑Sent Events (SSE) for low latency and stability.
Are there permissions for advanced tools? Features like map_poi_extract require additional authorization.
How do I set the environment variable? Use API_KEY (or the SDK‑specific variable) to pass your Baidu Maps API key.

中文| English

🚀 Introduction

Baidu Map MCP Server is a fully MCP-compliant, open-source Location-Based Service (LBS) solution, providing a comprehensive suite of geospatial APIs and tools for developers and AI agents. As the first map service provider in China to support the Model Context Protocol (MCP), Baidu Map MCP Server bridges the gap between large language models (LLMs), AI agents, and real-world location data and services.

With Baidu Map MCP Server, you can easily empower your applications, LLMs, and agents with advanced mapping, geocoding, POI search, route planning, weather, traffic, and more — all via standardized, developer-friendly MCP interfaces.

Key Features:

Full MCP Protocol Support: Seamless integration with any MCP-compliant agent, LLM, or platform.
Rich LBS Capabilities: Geocoding, reverse geocoding, POI search, route planning (driving, walking, cycling, transit), weather, IP location, real-time traffic, and more.
Cross-Platform SDKs: Official Python and TypeScript SDKs, easy CLI and cloud deployment.
Enterprise-Grade Data: Powered by Baidu Maps' authoritative, up-to-date geospatial data.
High Performance & Stability: Recommended SSE (Server-Sent Events) access for low latency and high reliability.
Open Source & Extensible: MIT licensed, easy to customize and extend.

Whether you are building a travel assistant, logistics platform, smart city solution, or an LLM-powered agent, Baidu Map MCP Server provides the essential geospatial intelligence and tools you need.

The MCP Server architecture enables:

Seamless AI Integration: Allows LLMs and agents to understand and process location data naturally
Contextual Understanding: Provides rich geospatial context for more intelligent decision-making
Standardized Interfaces: Consistent API design following MCP principles for easy integration
Scalable Implementation: Suitable for projects of any size, from small applications to enterprise solutions

Whether you're building a navigation app, delivery service, smart city solution, or enhancing an AI agent with location awareness, Baidu Map MCP Server provides the tools and infrastructure you need to succeed.

🛠️ Supported Tools & APIs

Baidu Map MCP Server provides the following MCP-compliant APIs (tools):

Tool Name	Description
`map_geocode`	Convert address to geographic coordinates.
`map_reverse_geocode`	Get address, region, and POI info from coordinates.
`map_search_places`	Search for global POIs by keyword, type, region, or within a radius.
`map_place_details`	Get detailed info for a POI by its unique ID.
`map_directions_matrix`	Batch route planning for multiple origins/destinations (driving, walking, cycling).
`map_directions`	Plan routes between two points (driving, walking, cycling, transit).
`map_weather`	Query real-time and forecast weather by region or coordinates.
`map_ip_location`	Locate city and coordinates by IP address.
`map_road_traffic`	Query real-time traffic conditions for roads or regions.
`map_poi_extract`*	Extract POI info from free text (requires advanced permission).

*Some advanced features require additional permissions. See Authorization for details.

All APIs follow the MCP protocol and can be called from any MCP-compliant client, LLM, or agent platform.

⚡ Quick Start

1. Get Your API Key

Register and create a server-side API Key (AK) at Baidu Maps Open Platform. Be sure to enable “MCP (SSE)” service for best performance.

2. Python Integration

Install the SDK:

pip install mcp-server-baidu-maps

Run as a script:

python -m mcp_server_baidu_maps

Configure in your MCP client (e.g., Claude, Cursor):

{
  "mcpServers": {
    "baidu-maps": {
      "command": "python",
      "args": ["-m", "mcp_server_baidu_maps"],
      "env": {
        "BAIDU_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

3. Node.js/TypeScript Integration

Install:

npm install @baidumap/mcp-server-baidu-map

Configure in your MCP client:

{
  "mcpServers": {
    "baidu-map": {
      "command": "npx",
      "args": [
        "-y",
        "@baidumap/mcp-server-baidu-map"
      ],
      "env": {
        "BAIDU_MAP_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

4. Recommended: Use SSE for low-latency, stable access

See SSE Quickstart.

5. More Platforms

Claude/Agent/千帆AppBuilder: See README_zh.md for detailed integration guides and advanced configuration.

🚀 Advanced Use Cases

Travel Planning Assistant:
Use map_search_places, map_directions, and map_weather to build an agent that plans optimal sightseeing routes, checks weather, and recommends POIs.
Batch Route Matrix:
Use map_directions_matrix to calculate multiple routes and durations for logistics or delivery optimization.
Text-to-POI Extraction:
Use map_poi_extract to extract POIs from user input or travel notes (requires advanced permission).
Real-time Traffic & Weather-aware Navigation:
Combine map_road_traffic and map_weather for dynamic, context-aware travel suggestions.
Integration with Claude, Qianfan, AppBuilder:
Seamlessly connect Baidu Map MCP Server to LLMs and agent frameworks for natural language geospatial reasoning.

See README_zh.md for more detailed Chinese documentation, configuration, and examples.

⛰️ Advanced Tutorials

👩‍👩‍👧‍👦 Contributors

🌟 Star History

📄 License

{ "mcpServers": { "baidu-map": { "command": "npx", "args": [ "-y", "@baidumap/mcp-server-baidu-map" ], "env": { "API_KEY": "<YOUR_API_KEY>" } } } }

Baidu Map MCP Server