Baidu Map

Un servicio basado en ubicación (LBS) que proporciona APIs geoespaciales para geocodificación, búsqueda de POI, planificación de rutas y más.

GitHub

445

Prueba este MCPPatrocinado

Documentación

中文| English

🚀 Introducción

Baidu Map MCP Server es una solución de Servicio Basado en Ubicación (LBS) de código abierto, totalmente compatible con MCP, que proporciona un conjunto completo de APIs y herramientas geoespaciales para desarrolladores y agentes de IA. Como el primer proveedor de servicios de mapas en China en admitir el Protocolo de Contexto de Modelo (MCP), Baidu Map MCP Server cierra la brecha entre los grandes modelos de lenguaje (LLMs), los agentes de IA y los datos y servicios de ubicación del mundo real.

Con Baidu Map MCP Server, puede potenciar fácilmente sus aplicaciones, LLMs y agentes con funciones avanzadas de mapeo, geocodificación, búsqueda de POI, planificación de rutas, clima, tráfico y más, todo a través de interfaces MCP estandarizadas y amigables para desarrolladores.

Características clave:

Soporte completo del protocolo MCP: Integración perfecta con cualquier agente, LLM o plataforma compatible con MCP.
Capacidades LBS enriquecidas: Geocodificación, geocodificación inversa, búsqueda de POI, planificación de rutas (conducción, caminata, ciclismo, transporte público), clima, ubicación por IP, tráfico en tiempo real y más.
SDKs multiplataforma: SDKs oficiales para Python y TypeScript, implementación sencilla mediante CLI y nube.
Datos de nivel empresarial: Impulsado por los datos geoespaciales autoritativos y actualizados de Baidu Maps.
Alto rendimiento y estabilidad: Acceso SSE (Server-Sent Events) recomendado para baja latencia y alta confiabilidad.
Código abierto y extensible: Licencia MIT, fácil de personalizar y ampliar.

Ya sea que esté construyendo un asistente de viajes, una plataforma logística, una solución de ciudad inteligente o un agente impulsado por LLM, Baidu Map MCP Server proporciona la inteligencia geoespacial y las herramientas esenciales que necesita.

La arquitectura del servidor MCP permite:

Integración fluida con IA: Permite que los LLMs y agentes comprendan y procesen datos de ubicación de manera natural
Comprensión contextual: Proporciona un contexto geoespacial enriquecido para una toma de decisiones más inteligente
Interfaces estandarizadas: Diseño de API consistente siguiendo los principios de MCP para una integración sencilla
Implementación escalable: Adecuado para proyectos de cualquier tamaño, desde aplicaciones pequeñas hasta soluciones empresariales

Ya sea que esté creando una aplicación de navegación, un servicio de entrega, una solución de ciudad inteligente o mejorando un agente de IA con conciencia de ubicación, Baidu Map MCP Server proporciona las herramientas y la infraestructura que necesita para tener éxito.

🛠️ Herramientas y APIs compatibles

Baidu Map MCP Server proporciona las siguientes APIs (herramientas) compatibles con MCP:

Nombre de la herramienta	Descripción
`map_geocode`	Convierte direcciones en coordenadas geográficas.
`map_reverse_geocode`	Obtiene dirección, región e información de POI a partir de coordenadas.
`map_search_places`	Busca POIs globales por palabra clave, tipo, región o dentro de un radio.
`map_place_details`	Obtiene información detallada de un POI por su ID único.
`map_directions_matrix`	Planificación de rutas por lotes para múltiples orígenes/destinos (conducción, caminata, ciclismo).
`map_directions`	Planifica rutas entre dos puntos (conducción, caminata, ciclismo, transporte público).
`map_weather`	Consulta el clima en tiempo real y pronósticos por región o coordenadas.
`map_ip_location`	Localiza ciudad y coordenadas mediante dirección IP.
`map_road_traffic`	Consulta condiciones de tráfico en tiempo real para carreteras o regiones.
`map_poi_extract`*	Extrae información de POI de texto libre (requiere permiso avanzado).

*Algunas funciones avanzadas requieren permisos adicionales. Consulte Autorización para más detalles.

Todas las APIs siguen el protocolo MCP y pueden ser llamadas desde cualquier cliente, LLM o plataforma de agentes compatible con MCP.

⚡ Inicio rápido

1. Obtenga su clave de API

Regístrese y cree una clave de API de servidor (AK) en Plataforma Abierta de Baidu Maps. Asegúrese de habilitar el servicio "MCP (SSE)" para un mejor rendimiento.

2. Integración con Python

Instale el SDK:

pip install mcp-server-baidu-maps

Ejecutar como script:

python -m mcp_server_baidu_maps

Configurar en su cliente MCP (por ejemplo, Claude, Cursor):

{
  "mcpServers": {
    "baidu-maps": {
      "command": "python",
      "args": ["-m", "mcp_server_baidu_maps"],
      "env": {
        "BAIDU_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

3. Integración con Node.js/TypeScript

Instale:

npm install @baidumap/mcp-server-baidu-map

Configurar en su cliente MCP:

{
  "mcpServers": {
    "baidu-map": {
      "command": "npx",
      "args": [
        "-y",
        "@baidumap/mcp-server-baidu-map"
      ],
      "env": {
        "BAIDU_MAP_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

4. Recomendado: Use SSE para acceso estable y de baja latencia

Consulte Inicio rápido con SSE.

5. Más plataformas

Claude/Agent/千帆AppBuilder: Consulte README_zh.md para guías de integración detalladas y configuración avanzada.

🚀 Casos de uso avanzados

Asistente de planificación de viajes:
Use map_search_places, map_directions y map_weather para construir un agente que planifique rutas turísticas óptimas, consulte el clima y recomiende POIs.
Matriz de rutas por lotes:
Use map_directions_matrix para calcular múltiples rutas y duraciones para optimización logística o de entregas.
Extracción de texto a POI:
Use map_poi_extract para extraer POIs de entradas de usuario o notas de viaje (requiere permiso avanzado).
Navegación consciente del tráfico y clima en tiempo real:
Combine map_road_traffic y map_weather para sugerencias de viaje dinámicas y contextuales.
Integración con Claude, Qianfan, AppBuilder:
Conecte Baidu Map MCP Server sin problemas a LLMs y marcos de agentes para razonamiento geoespacial en lenguaje natural.

Consulte README_zh.md para documentación, configuración y ejemplos más detallados en chino.