Baidu Maps
Baidu Map MCP Server
What is Baidu Maps?
Baidu Maps is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to baidu map mcp server
Baidu Map MCP Server
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Baidu Map MCP Server
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx baidumapConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Baidu Maps
The Baidu Maps MCP Server connects AI assistants to Baidu's location-based services platform, giving them access to geocoding, reverse geocoding, place-of-interest search, multi-modal route planning, real-time traffic data, weather queries, and IP-based location detection. It is the primary mapping solution for AI applications targeting mainland China, where Google Maps is unavailable, and is used by developers building travel assistants, logistics optimizers, and location-aware chatbots that need accurate Chinese addresses, POI data, and driving or transit routes.
Prerequisites
- A Baidu Maps Open Platform developer account and a server-side API key obtained from https://lbsyun.baidu.com/apiconsole/key
- Python 3.8+ (for the Python package) or Node.js 16+ (for the npm package)
- An MCP-compatible client such as Claude Desktop or Claude Code
- The MCP (SSE) service enabled on your Baidu Maps API key for best performance
Create a Baidu Maps API key
Log in to the Baidu Maps Open Platform console at https://lbsyun.baidu.com/apiconsole/key, create a new application, and generate a server-side API key. Enable the MCP (SSE) service type on the key for optimal compatibility.
Install the server package
Install either the Python or Node.js package depending on your preference. Both expose the same MCP tools.
# Python
pip install mcp-server-baidu-maps
# Node.js
npm install @baidumap/mcp-server-baidu-mapConfigure Claude Desktop with the Python package
Add the server to your claude_desktop_config.json. Pass your API key via the BAIDU_MAPS_API_KEY environment variable.
{
"mcpServers": {
"baidu-maps": {
"command": "python",
"args": ["-m", "mcp_server_baidu_maps"],
"env": {
"BAIDU_MAPS_API_KEY": "YOUR_BAIDU_MAPS_API_KEY"
}
}
}
}Configure Claude Desktop with the Node.js package
If you prefer the npm package, use the npx command and the BAIDU_MAP_API_KEY environment variable name (note: no 'S' at the end).
{
"mcpServers": {
"baidu-maps": {
"command": "npx",
"args": ["-y", "@baidumap/mcp-server-baidu-map"],
"env": {
"BAIDU_MAP_API_KEY": "YOUR_BAIDU_MAPS_API_KEY"
}
}
}
}Verify available tools
After restarting your MCP client, ask the AI to list the Baidu Maps tools. You should see tools for geocoding, reverse geocoding, POI search, route planning (driving, walking, transit), weather queries, IP location, and traffic data.
Baidu Maps Examples
Client configuration
Claude Desktop configuration using the Python mcp-server-baidu-maps package with an API key.
{
"mcpServers": {
"baidu-maps": {
"command": "python",
"args": ["-m", "mcp_server_baidu_maps"],
"env": {
"BAIDU_MAPS_API_KEY": "YOUR_BAIDU_MAPS_API_KEY"
}
}
}
}Prompts to try
Location-based queries and planning tasks that the Baidu Maps tools can handle.
- "What is the latitude and longitude of the Forbidden City in Beijing?"
- "Find the top 5 Sichuan restaurants near Chengdu Tianfu Square"
- "Plan a driving route from Shanghai Pudong Airport to the Bund and show estimated travel time"
- "What is the current weather in Shenzhen?"
- "What is my approximate location based on this IP address: 111.206.145.41?"Troubleshooting Baidu Maps
API returns 'ak error' or authentication failure
Double-check that you are using a server-side API key, not a browser key. In the Baidu Maps console, the key type must be 'Server' (服务端). Also verify the correct environment variable name: BAIDU_MAPS_API_KEY for Python, BAIDU_MAP_API_KEY for Node.js.
Route planning returns no results for a valid address
Baidu Maps coordinates use the BD-09 coordinate system, which differs from WGS-84 (GPS) and GCJ-02 (Google China). Use the geocoding tool to convert addresses to BD-09 coordinates before passing them to route planning tools.
POI search returns results outside the expected city
Specify the city parameter explicitly in your search request. Without a city constraint, the API may return nationwide results ranked by relevance rather than proximity.
Frequently Asked Questions about Baidu Maps
What is Baidu Maps?
Baidu Maps is a Model Context Protocol (MCP) server that baidu map mcp server It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Baidu Maps?
Follow the installation instructions on the Baidu Maps GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Baidu Maps?
Baidu Maps works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Baidu Maps free to use?
Yes, Baidu Maps is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Baidu Maps Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Baidu Maps? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Baidu Maps in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Baidu Maps?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.