Como Usar o Servidor MCP do Baidu Map: Um Guia Passo a Passo
O Servidor MCP do Baidu Map é uma solução de serviço de localização (LBS) totalmente compatível com MCP e de código aberto, que capacita agentes e aplicações de IA com robustas capacidades geoespaciais, como geocodificação, busca de POIs, planejamento de rotas, dados de tráfego e muito mais. Este guia o orienta no processo de configuração e uso no seu ecossistema MCP.
O Que Você Vai Precisar
Antes de começar, certifique-se de ter o seguinte:
- Uma conta na Plataforma Aberta do Baidu Map
- Uma Chave de API (AK) do lado do servidor
- Um cliente compatível com MCP, como Claude, Cursor ou seu agente personalizado
- Node.js e npm instalados localmente (para integração com Node)
Passo 1: Obtenha Sua Chave de API do Baidu Maps
- Visite a Plataforma Aberta do Baidu Map e faça login.
- Crie um novo aplicativo e ative as APIs necessárias.
- Certifique-se de que o serviço “MCP (SSE)” esteja ativado para desempenho ideal.
- Copie sua Chave de API (AK) — você precisará dela para a configuração do servidor.
Passo 2: Configure Seu Servidor MCP
Para integrar o Servidor MCP do Baidu Map ao seu cliente MCP, use a seguinte configuração:
{
"mcpServers": {
"baidu-map": {
"command": "npx",
"args": [
"-y",
"@baidumap/mcp-server-baidu-map"
],
"env": {
"BAIDU_MAP_API_KEY": "xxx"
}
}
}
}
Substitua
"xxx"pela sua Chave de API do Baidu real.
Você pode colocar isso no seu mcp.config.json ou arquivo de configuração equivalente, dependendo da sua plataforma (Claude, Qianfan, etc.).
Passo 3: Instale e Execute o Servidor
No seu terminal, basta executar:
npx -y @baidumap/mcp-server-baidu-map
Isso iniciará o servidor do Baidu Map compatível com MCP e exporá um conjunto de APIs padronizadas para seu agente consumir.
Ferramentas e APIs Suportadas
O Servidor MCP do Baidu Map fornece um rico conjunto de ferramentas, incluindo:
| Nome da Ferramenta | Descrição |
|---|---|
map_geocode | Converter endereço em coordenadas geográficas |
map_reverse_geocode | Obter informações de POI e endereço a partir de coordenadas |
map_search_places | Buscar pontos de interesse por palavra-chave, região, etc. |
map_place_details | Obter informações detalhadas de POI |
map_directions | Planejar rotas (dirigindo, caminhando, ciclismo, transporte) |
map_directions_matrix | Planejamento de rotas em lote |
map_weather | Dados de clima em tempo real e previsão |
map_ip_location | Localizar posição usando um endereço IP |
map_road_traffic | Condições de tráfego em tempo real |
map_poi_extract* | Extrair POIs de texto livre (requer permissão) |
Exemplos de Casos de Uso
Assistente de Navegação e Viagem
Planeje viagens com verificações de clima e sugestões de POIs:
map_search_places+map_directions+map_weather
Otimização Logística
Calcule rotas de entrega em lote:
map_directions_matrix
Integração de LLM
Habilite raciocínio geoespacial em grandes modelos de linguagem:
- Claude ou AppBuilder + ferramentas
map_*
Recapitulando Rápido
| Tarefa | Ferramenta/API a Usar |
|---|---|
| Converter endereço em coordenadas | map_geocode |
| Encontrar um restaurante próximo | map_search_places |
| Obter o clima de uma localização | map_weather |
| Planejar rotas de entrega | map_directions_matrix |
Saiba Mais
Visite a página oficial do Servidor MCP do Baidu Map no MCP Server Hub para documentação, perguntas frequentes e casos de uso avançados.
Se você está construindo um agente inteligente, aplicativo de entrega ou assistente alimentado por LLM — o Servidor MCP do Baidu Map fornece tudo o que você precisa para adicionar inteligência geoespacial poderosa e em tempo real ao seu projeto.
