Baidu Karte

Empfohlen
Erstellt vonbaidu-mapsbaidu-maps

Die Kern-API von Baidu Maps ist jetzt vollständig mit dem MCP-Protokoll kompatibel, wodurch es der erste Kartenservice-Anbieter in China ist, der mit dem MCP-Protokoll kompatibel ist.

Übersicht

Was ist Baidu Map?

Baidu Map ist ein zentraler API-Dienst, der vollständig mit dem MCP-Protokoll kompatibel ist, wodurch es der erste Kartenanbieter in China ist, der dieses Protokoll unterstützt.

Wie verwendet man Baidu Map?

Um Baidu Map zu verwenden, müssen Sie einen serverseitigen API-Schlüssel (AK) auf der Baidu Map Open Platform erstellen und dann die API mit Python oder TypeScript SDKs integrieren.

Hauptmerkmale von Baidu Map

  • Bietet 8 zentrale API-Schnittstellen, einschließlich Geokodierung, Rückwärtsgeokodierung, Standortsuche, Routenplanung und Wetterabfragen.
  • Unterstützt die Integration mit intelligenten Assistenten, die mit dem MCP-Protokoll kompatibel sind.

Anwendungsfälle von Baidu Map

  1. Umwandlung von Adressen in Koordinaten (Geokodierung).
  2. Abrufen detaillierter Informationen über Sehenswürdigkeiten (POIs).
  3. Planung von Routen für Autofahren, Gehen oder öffentliche Verkehrsmittel.
  4. Abfragen des aktuellen Wetters basierend auf dem Standort.

FAQ zu Baidu Map

  • Was ist das MCP-Protokoll?

    Das MCP-Protokoll ist ein Standard zur Integration verschiedener Dienste und Tools auf eine einheitliche Weise. Weitere Details finden Sie in der offiziellen MCP-Dokumentation.

  • Fallen Kosten für die Nutzung der Baidu Map API an?

    Die Nutzungskosten der Baidu Map API können variieren; bitte überprüfen Sie die Baidu Map Open Platform für Preisinformationen.

  • Wie kann ich Probleme mit der API beheben?

    Sie können auf die offizielle Dokumentation oder Community-Foren für Tipps zur Fehlersuche verweisen.

Detail

stars python MIT License pypi npm

</div> <br>

🚀 Introduction

Baidu Map MCP Server is a fully MCP-compliant, open-source Location-Based Service (LBS) solution, providing a comprehensive suite of geospatial APIs and tools for developers and AI agents. As the first map service provider in China to support the Model Context Protocol (MCP), Baidu Map MCP Server bridges the gap between large language models (LLMs), AI agents, and real-world location data and services.

With Baidu Map MCP Server, you can easily empower your applications, LLMs, and agents with advanced mapping, geocoding, POI search, route planning, weather, traffic, and more — all via standardized, developer-friendly MCP interfaces.

Key Features:

  • Full MCP Protocol Support: Seamless integration with any MCP-compliant agent, LLM, or platform.
  • Rich LBS Capabilities: Geocoding, reverse geocoding, POI search, route planning (driving, walking, cycling, transit), weather, IP location, real-time traffic, and more.
  • Cross-Platform SDKs: Official Python and TypeScript SDKs, easy CLI and cloud deployment.
  • Enterprise-Grade Data: Powered by Baidu Maps' authoritative, up-to-date geospatial data.
  • High Performance & Stability: Recommended SSE (Server-Sent Events) access for low latency and high reliability.
  • Open Source & Extensible: MIT licensed, easy to customize and extend.

Whether you are building a travel assistant, logistics platform, smart city solution, or an LLM-powered agent, Baidu Map MCP Server provides the essential geospatial intelligence and tools you need.

The MCP Server architecture enables:

  • Seamless AI Integration: Allows LLMs and agents to understand and process location data naturally
  • Contextual Understanding: Provides rich geospatial context for more intelligent decision-making
  • Standardized Interfaces: Consistent API design following MCP principles for easy integration
  • Scalable Implementation: Suitable for projects of any size, from small applications to enterprise solutions

Whether you're building a navigation app, delivery service, smart city solution, or enhancing an AI agent with location awareness, Baidu Map MCP Server provides the tools and infrastructure you need to succeed.

🛠️ Supported Tools & APIs

Baidu Map MCP Server provides the following MCP-compliant APIs (tools):

Tool NameDescription
map_geocodeConvert address to geographic coordinates.
map_reverse_geocodeGet address, region, and POI info from coordinates.
map_search_placesSearch for POIs by keyword, type, region, or within a radius.
map_place_detailsGet detailed info for a POI by its unique ID.
map_directions_matrixBatch route planning for multiple origins/destinations (driving, walking, cycling).
map_directionsPlan routes between two points (driving, walking, cycling, transit).
map_weatherQuery real-time and forecast weather by region or coordinates.
map_ip_locationLocate city and coordinates by IP address.
map_road_trafficQuery real-time traffic conditions for roads or regions.
map_poi_extract*Extract POI info from free text (requires advanced permission).

*Some advanced features require additional permissions. See Authorization for details.

All APIs follow the MCP protocol and can be called from any MCP-compliant client, LLM, or agent platform.

⚡ Quick Start

1. Get Your API Key

Register and create a server-side API Key (AK) at Baidu Maps Open Platform. Be sure to enable “MCP (SSE)” service for best performance.

2. Python Integration

Install the SDK:

pip install mcp-server-baidu-maps

Run as a script:

python -m mcp_server_baidu_maps

Configure in your MCP client (e.g., Claude, Cursor):

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

3. Node.js/TypeScript Integration

Install:

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

Configure in your MCP client:

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

4. Recommended: Use SSE for low-latency, stable access

See SSE Quickstart.

5. More Platforms

  • Claude/Agent/千帆AppBuilder: See README_zh.md for detailed integration guides and advanced configuration.

🚀 Advanced Use Cases

  • Travel Planning Assistant:
    Use map_search_places, map_directions, and map_weather to build an agent that plans optimal sightseeing routes, checks weather, and recommends POIs.

  • Batch Route Matrix:
    Use map_directions_matrix to calculate multiple routes and durations for logistics or delivery optimization.

  • Text-to-POI Extraction:
    Use map_poi_extract to extract POIs from user input or travel notes (requires advanced permission).

  • Real-time Traffic & Weather-aware Navigation:
    Combine map_road_traffic and map_weather for dynamic, context-aware travel suggestions.

  • Integration with Claude, Qianfan, AppBuilder:
    Seamlessly connect Baidu Map MCP Server to LLMs and agent frameworks for natural language geospatial reasoning.

See README_zh.md for more detailed Chinese documentation, configuration, and examples.


⛰️ Advanced Tutorials

👩‍👩‍👧‍👦 Contributors

<a href="https://github.com/baidu-maps/mcp/graphs/contributors"> <img src="https://contrib.rocks/image?repo=baidu-maps/mcp&max=400&columns=20" width="200"/> </a>

🌟 Star History

Star History Chart

📄 License

MIT © baidu-maps

Serverkonfiguration

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

Projektinfo

Empfohlen
Autor
baidu-maps
Erstellt am
Jun 21, 2025
Stern
293
Sprache
Python