Cómo usar el servidor MCP de Baidu Map: Una guía paso a paso
El Servidor MCP de Baidu Map es una solución de servicio basado en ubicación (LBS) de código abierto y completamente compatible con MCP que potencia a los agentes y aplicaciones de IA con capacidades geoespaciales robustas, como geocodificación, búsqueda de POI, planificación de rutas, datos de tráfico y más. Esta guía te llevará a través del proceso de configuración y uso en tu ecosistema MCP.
Lo Que Necesitarás
Antes de comenzar, asegúrate de tener lo siguiente:
- Una cuenta de Plataforma Abierta de Baidu Map
- Una Clave API del lado del servidor (AK)
- Un cliente compatible con MCP como Claude, Cursor o tu agente personalizado
- Node.js y npm instalados localmente (para la integración de Node)
Paso 1: Obtén Tu Clave API de Baidu Maps
- Visita la Plataforma Abierta de Baidu Map e inicia sesión.
- Crea una nueva aplicación y habilita las APIs requeridas.
- Asegúrate de que el servicio “MCP (SSE)” esté habilitado para un rendimiento óptimo.
- Copia tu Clave API (AK); la necesitarás para la configuración del servidor.
Paso 2: Configura Tu Servidor MCP
Para integrar el Servidor MCP de Baidu Map en tu cliente MCP, utiliza la siguiente configuración:
{
"mcpServers": {
"baidu-map": {
"command": "npx",
"args": [
"-y",
"@baidumap/mcp-server-baidu-map"
],
"env": {
"BAIDU_MAP_API_KEY": "xxx"
}
}
}
}
Reemplaza
"xxx"con tu Clave API de Baidu real.
Puedes colocar esto en tu mcp.config.json o en el archivo de configuración equivalente dependiendo de tu plataforma (Claude, Qianfan, etc.).
Paso 3: Instala y Ejecuta el Servidor
En tu terminal, simplemente ejecuta:
npx -y @baidumap/mcp-server-baidu-map
Esto lanzará el servidor de Baidu Map compatible con MCP y expondrá un conjunto de APIs estandarizadas para que tu agente las consuma.
Herramientas y APIs Soportadas
El Servidor MCP de Baidu Map proporciona un rico conjunto de herramientas, incluyendo:
| Nombre de la Herramienta | Descripción |
|---|---|
map_geocode | Convierte direcciones en coordenadas geográficas |
map_reverse_geocode | Obtiene información de POI y direcciones a partir de coordenadas |
map_search_places | Busca puntos de interés por palabra clave, región, etc. |
map_place_details | Obtiene información detallada de POI |
map_directions | Planifica rutas (conducción, caminata, ciclismo, transporte) |
map_directions_matrix | Planificación de rutas por lotes |
map_weather | Datos meteorológicos en tiempo real y pronósticos |
map_ip_location | Localiza la posición usando una dirección IP |
map_road_traffic | Condiciones de tráfico en tiempo real |
map_poi_extract* | Extrae POIs de texto libre (requiere permiso) |
Casos de Uso Ejemplares
Asistente de Navegación y Viajes
Planifica viajes con verificaciones del clima y sugerencias de POI:
map_search_places+map_directions+map_weather
Optimización de Logística
Calcula por lotes las rutas de entrega:
map_directions_matrix
Integración de LLM
Habilita el razonamiento geoespacial en modelos de lenguaje grandes:
- Claude o AppBuilder + herramientas
map_*
Resumen Rápido
| Tarea | Herramienta/API a Usar |
|---|---|
| Convertir dirección a coordenadas | map_geocode |
| Encontrar un restaurante cercano | map_search_places |
| Obtener el clima de una ubicación | map_weather |
| Planificar rutas de entrega | map_directions_matrix |
Aprende Más
Visita la página oficial del Servidor MCP de Baidu Map en MCP Server Hub para documentación, preguntas frecuentes y casos de uso avanzados.
Si estás construyendo un agente inteligente, una aplicación de entrega o un asistente potenciado por LLM, el Servidor MCP de Baidu Map proporciona todo lo que necesitas para agregar inteligencia geoespacial poderosa y en tiempo real a tu proyecto.
