Baidu Map

Um Serviço Baseado em Localização (LBS) que fornece APIs geoespaciais para geocodificação, busca de POI, planejamento de rotas e muito mais.

GitHub

445

Experimente este MCPPatrocinado

Documentação

中文| English

🚀 Introdução

Baidu Map MCP Server é uma solução de Serviço Baseado em Localização (LBS) de código aberto, totalmente compatível com MCP, que fornece um conjunto abrangente de APIs e ferramentas geoespaciais para desenvolvedores e agentes de IA. Como o primeiro provedor de serviços de mapas na China a suportar o Model Context Protocol (MCP), o Baidu Map MCP Server preenche a lacuna entre grandes modelos de linguagem (LLMs), agentes de IA e dados e serviços de localização do mundo real.

Com o Baidu Map MCP Server, você pode facilmente capacitar seus aplicativos, LLMs e agentes com mapeamento avançado, geocodificação, busca de POI, planejamento de rotas, clima, trânsito e muito mais — tudo por meio de interfaces MCP padronizadas e amigáveis para desenvolvedores.

Principais Recursos:

Suporte Completo ao Protocolo MCP: Integração perfeita com qualquer agente, LLM ou plataforma compatível com MCP.
Ampla Gama de Recursos LBS: Geocodificação, geocodificação reversa, busca de POI, planejamento de rotas (carro, a pé, bicicleta, transporte público), clima, localização por IP, trânsito em tempo real e muito mais.
SDKs Multiplataforma: SDKs oficiais em Python e TypeScript, fácil implantação via CLI e nuvem.
Dados de Nível Empresarial: Alimentado pelos dados geoespaciais autoritativos e atualizados do Baidu Maps.
Alto Desempenho e Estabilidade: Acesso SSE (Server-Sent Events) recomendado para baixa latência e alta confiabilidade.
Código Aberto e Extensível: Licenciado sob MIT, fácil de personalizar e estender.

Esteja você construindo um assistente de viagens, uma plataforma de logística, uma solução de cidade inteligente ou um agente baseado em LLM, o Baidu Map MCP Server fornece a inteligência geoespacial e as ferramentas essenciais que você precisa.

A arquitetura do MCP Server permite:

Integração Perfeita com IA: Permite que LLMs e agentes entendam e processem dados de localização de forma natural
Compreensão Contextual: Fornece contexto geoespacial rico para tomada de decisões mais inteligente
Interfaces Padronizadas: Design de API consistente seguindo os princípios do MCP para integração fácil
Implementação Escalável: Adequado para projetos de qualquer tamanho, desde pequenos aplicativos até soluções empresariais

Esteja você construindo um aplicativo de navegação, um serviço de entrega, uma solução de cidade inteligente ou aprimorando um agente de IA com consciência de localização, o Baidu Map MCP Server fornece as ferramentas e a infraestrutura necessárias para o seu sucesso.

🛠️ Ferramentas e APIs Suportadas

O Baidu Map MCP Server fornece as seguintes APIs (ferramentas) compatíveis com MCP:

Nome da Ferramenta	Descrição
`map_geocode`	Converte endereço em coordenadas geográficas.
`map_reverse_geocode`	Obtém endereço, região e informações de POI a partir de coordenadas.
`map_search_places`	Busca POIs globais por palavra-chave, tipo, região ou dentro de um raio.
`map_place_details`	Obtém informações detalhadas de um POI pelo seu ID único.
`map_directions_matrix`	Planejamento de rotas em lote para múltiplas origens/destinos (carro, a pé, bicicleta).
`map_directions`	Planeja rotas entre dois pontos (carro, a pé, bicicleta, transporte público).
`map_weather`	Consulta clima em tempo real e previsão do tempo por região ou coordenadas.
`map_ip_location`	Localiza cidade e coordenadas pelo endereço IP.
`map_road_traffic`	Consulta condições de trânsito em tempo real para estradas ou regiões.
`map_poi_extract`*	Extrai informações de POI de texto livre (requer permissão avançada).

*Alguns recursos avançados exigem permissões adicionais. Consulte Autorização para obter detalhes.

Todas as APIs seguem o protocolo MCP e podem ser chamadas a partir de qualquer cliente, LLM ou plataforma de agente compatível com MCP.

⚡ Início Rápido

1. Obtenha Sua Chave de API

Registre-se e crie uma Chave de API (AK) no Baidu Maps Open Platform. Certifique-se de habilitar o serviço "MCP (SSE)" para obter o melhor desempenho.

2. Integração com Python

Instale o SDK:

pip install mcp-server-baidu-maps

Execute como script:

python -m mcp_server_baidu_maps

Configure no seu cliente MCP (ex.: Claude, Cursor):

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

3. Integração com Node.js/TypeScript

Instale:

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

Configure no seu 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 acesso estável e de baixa latência

Consulte Início Rápido com SSE.

5. Mais Plataformas

Claude/Agent/千帆AppBuilder: Consulte README_zh.md para guias de integração detalhados e configuração avançada.

🚀 Casos de Uso Avançados

Assistente de Planejamento de Viagens:
Use map_search_places, map_directions e map_weather para criar um agente que planeja rotas turísticas ideais, verifica o clima e recomenda POIs.
Matriz de Rotas em Lote:
Use map_directions_matrix para calcular múltiplas rotas e durações para otimização de logística ou entregas.
Extração de POI a partir de Texto:
Use map_poi_extract para extrair POIs de entrada do usuário ou notas de viagem (requer permissão avançada).
Navegação com Consciência de Trânsito e Clima em Tempo Real:
Combine map_road_traffic e map_weather para sugestões de viagem dinâmicas e sensíveis ao contexto.
Integração com Claude, Qianfan, AppBuilder:
Conecte o Baidu Map MCP Server a LLMs e frameworks de agentes para raciocínio geoespacial em linguagem natural.

Consulte README_zh.md para documentação, configuração e exemplos mais detalhados em chinês.