如何使用百度地图MCP服务器:逐步指南
Baidu 地圖 MCP 伺服器 是一個完全符合 MCP 標準的開源位置基礎服務 (LBS) 解決方案,為 AI 代理和應用提供強大的地理空間能力,如地理編碼、POI 搜索、路徑規劃、交通數據等。這個指南將引導您完成設置和在您的 MCP 生態系統中使用它的過程。
您需要的東西
在開始之前,請確保您擁有以下內容:
- 一個 Baidu 地圖開放平台 帳戶
- 一個 伺服器端 API 金鑰 (AK)
- 一個兼容 MCP 的客戶端,如 Claude、Cursor 或您的自定義代理
- 本地安裝的 Node.js 和 npm(用於 Node 集成)
步驟 1:獲取您的 Baidu 地圖 API 金鑰
- 訪問 Baidu 地圖開放平台 並登錄。
- 創建一個新應用並啟用所需的 API。
- 確保啟用 “MCP (SSE)” 服務以獲得最佳性能。
- 複製您的 API 金鑰 (AK) — 您將在伺服器配置中需要它。
步驟 2:配置您的 MCP 伺服器
要將 Baidu 地圖 MCP 伺服器集成到您的 MCP 客戶端中,請使用以下配置:
{
"mcpServers": {
"baidu-map": {
"command": "npx",
"args": [
"-y",
"@baidumap/mcp-server-baidu-map"
],
"env": {
"BAIDU_MAP_API_KEY": "xxx"
}
}
}
}
將
"xxx"
替換為您的實際 Baidu API 金鑰。
您可以將其放置在您的 mcp.config.json
或根據您的平台(Claude、Qianfan 等)相應的配置文件中。
步驟 3:安裝並運行伺服器
在您的終端中,簡單地運行:
npx -y @baidumap/mcp-server-baidu-map
這將啟動兼容 MCP 的 Baidu 地圖伺服器,並為您的代理提供一組標準化的 API 供其使用。
支持的工具和 API
Baidu 地圖 MCP 伺服器提供了一組豐富的工具,包括:
工具名稱 | 描述 |
---|---|
map_geocode | 將地址轉換為地理坐標 |
map_reverse_geocode | 從坐標獲取 POI 和地址信息 |
map_search_places | 按關鍵字、區域等搜索興趣點 |
map_place_details | 獲取詳細的 POI 信息 |
map_directions | 計劃路徑(駕駛、步行、騎行、公共交通) |
map_directions_matrix | 批量路徑規劃 |
map_weather | 實時和預報天氣數據 |
map_ip_location | 使用 IP 地址定位位置 |
map_road_traffic | 實時交通狀況 |
map_poi_extract * | 從自由文本中提取 POI(需要許可) |
示例用例
導航和旅行助手
計劃旅行時檢查天氣並提供 POI 建議:
map_search_places
+map_directions
+map_weather
物流優化
批量計算送貨路徑:
map_directions_matrix
LLM 集成
在大型語言模型中啟用地理空間推理:
- Claude 或 AppBuilder +
map_*
工具
快速回顧
任務 | 使用的工具/API |
---|---|
將地址轉換為坐標 | map_geocode |
找到附近的餐廳 | map_search_places |
獲取位置的天氣 | map_weather |
計劃送貨路徑 | map_directions_matrix |
瞭解更多
訪問官方 Baidu 地圖 MCP 伺服器頁面 獲取文檔、常見問題和高級用例。
如果您正在構建智能代理、送貨應用或 LLM 驅動的助手 — Baidu 地圖 MCP 伺服器提供了您需要的一切,以將強大的實時地理空間智能添加到您的項目中。