Как использовать сервер MCP карты Baidu: пошаговое руководство
Baidu Map MCP Server — это полностью совместимое с MCP, открытое решение для услуг на основе местоположения (LBS), которое предоставляет ИИ-агентам и приложениям мощные геопространственные возможности, такие как геокодирование, поиск POI, планирование маршрутов, данные о трафике и многое другое. Этот гид проведет вас через процесс его настройки и использования в вашей экосистеме MCP.
Что вам понадобится
Перед тем как начать, убедитесь, что у вас есть следующее:
- Учетная запись Baidu Map Open Platform
- Ключ API (AK) для серверной стороны
- Совместимый с MCP клиент, такой как Claude, Cursor или ваш собственный агент
- Установленные локально Node.js и npm (для интеграции с Node)
Шаг 1: Получите ваш ключ API Baidu Maps
- Посетите Baidu Map Open Platform и войдите в систему.
- Создайте новое приложение и активируйте необходимые API.
- Убедитесь, что служба “MCP (SSE)” включена для оптимальной производительности.
- Скопируйте ваш Ключ API (AK) — он понадобится для конфигурации сервера.
Шаг 2: Настройте ваш MCP сервер
Чтобы интегрировать Baidu Map MCP Server в ваш MCP клиент, используйте следующую конфигурацию:
{
"mcpServers": {
"baidu-map": {
"command": "npx",
"args": [
"-y",
"@baidumap/mcp-server-baidu-map"
],
"env": {
"BAIDU_MAP_API_KEY": "xxx"
}
}
}
}
Замените
"xxx"на ваш фактический ключ API Baidu.
Вы можете поместить это в ваш mcp.config.json или эквивалентный файл конфигурации в зависимости от вашей платформы (Claude, Qianfan и т.д.).
Шаг 3: Установите и запустите сервер
В вашем терминале просто выполните:
npx -y @baidumap/mcp-server-baidu-map
Это запустит совместимый с MCP сервер Baidu Map и предоставит набор стандартных API для вашего агента.
Поддерживаемые инструменты и API
Baidu Map MCP Server предоставляет богатый набор инструментов, включая:
| Название инструмента | Описание |
|---|---|
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 Map MCP Server на MCP Server Hub для документации, часто задаваемых вопросов и продвинутых примеров использования.
Если вы разрабатываете умного агента, приложение для доставки или помощника на базе LLM — Baidu Map MCP Server предоставляет все необходимое, чтобы добавить мощный, актуальный геопространственный интеллект в ваш проект.
