百度地図のコアAPIは現在、MCPプロトコルと完全に互換性があり、中国で初めてMCPプロトコルに対応した地図サービスプロバイダーとなりました。
概要
Baiduマップとは?
Baiduマップは、MCPプロトコルと完全に互換性のあるコアAPIサービスであり、中国でこのプロトコルをサポートする最初の地図サービスプロバイダーです。
Baiduマップの使い方は?
Baiduマップを使用するには、BaiduマップオープンプラットフォームでサーバーサイドAPIキー(AK)を作成し、その後PythonまたはTypeScript SDKを使用してAPIを統合する必要があります。
Baiduマップの主な機能
- ジオコーディング、逆ジオコーディング、場所検索、ルート計画、天気情報のクエリなど、8つのコアAPIインターフェースを提供します。
- MCPプロトコルに対応したインテリジェントアシスタントとの統合をサポートしています。
Baiduマップの使用例
- 住所を座標に変換する(ジオコーディング)。
- 興味のある地点(POI)に関する詳細情報を取得する。
- 車、徒歩、公共交通機関のルートを計画する。
- 場所に基づいて現在の天気をクエリする。
Baiduマップに関するFAQ
-
MCPプロトコルとは何ですか?
MCPプロトコルは、さまざまなサービスやツールを統一的に統合するための標準です。詳細は公式のMCPドキュメントをご覧ください。
-
BaiduマップAPIを使用するのに費用はかかりますか?
BaiduマップAPIの使用料金は異なる場合がありますので、価格の詳細はBaiduマップオープンプラットフォームをご確認ください。
-
APIの問題をトラブルシューティングするにはどうすればよいですか?
公式ドキュメントやコミュニティフォーラムを参照して、トラブルシューティングのヒントを得ることができます。
詳細
🚀 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 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:
Usemap_search_places
,map_directions
, andmap_weather
to build an agent that plans optimal sightseeing routes, checks weather, and recommends POIs. -
Batch Route Matrix:
Usemap_directions_matrix
to calculate multiple routes and durations for logistics or delivery optimization. -
Text-to-POI Extraction:
Usemap_poi_extract
to extract POIs from user input or travel notes (requires advanced permission). -
Real-time Traffic & Weather-aware Navigation:
Combinemap_road_traffic
andmap_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
- Geocoding API Guide
- POI Search API Guide
- Route Planning API Guide
- MCP Integration Guide
- SDK Development Guide
👩👩👧👦 Contributors
<a href="https://github.com/baidu-maps/mcp/graphs/contributors"> <img src="https://contrib.rocks/image?repo=baidu-maps/mcp&max=400&columns=20" width="200"/> </a>🌟 Star History
📄 License
MIT © baidu-maps
サーバー設定
{
"mcpServers": {
"baidu-map": {
"command": "npx",
"args": [
"-y",
"@baidumap/mcp-server-baidu-map"
],
"env": {
"BAIDU_MAP_API_KEY": "xxx"
}
}
}
}