valhalla-mcp

aatakansalar/valhalla-mcp

3.3

If you are the rightful owner of valhalla-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Valhalla MCP Server integrates Claude Desktop with the Valhalla Open-Street-Map routing engine, enabling professional routing and isochrone capabilities directly from AI conversations.

The Valhalla MCP Server is a robust solution designed to bridge the gap between AI-driven applications and advanced routing capabilities provided by the Valhalla Open-Street-Map engine. By leveraging the Model Context Protocol (MCP), this server facilitates seamless communication between Claude Desktop and Valhalla, allowing users to access sophisticated routing and isochrone functionalities without the need for complex API integrations. This integration is particularly beneficial for applications requiring precise geographic data and routing solutions, such as logistics planning, delivery optimization, and travel time analysis. The server supports various transportation modes, including car, bicycle, pedestrian, taxi, and bus, making it versatile for different use cases. With a focus on ease of use, the Valhalla MCP Server can be deployed locally or connected to an existing Valhalla server, providing flexibility for both development and production environments.

Features

  • Seamless integration with Claude Desktop for routing and isochrone capabilities.
  • Supports multiple transportation modes: auto, bicycle, pedestrian, taxi, and bus.
  • Provides detailed GeoJSON responses for route geometries and travel statistics.
  • Easy deployment with Docker and Docker Compose for local or remote Valhalla servers.
  • Comprehensive environment variable configuration for customization.

Usages

usage with Claude Desktop Demo API

{
  "mcpServers": {
    "valhalla-mcp": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/YOUR/PATH/TO/valhalla-mcp",
      "env": {
        "VALHALLA_BASE_URL": "https://valhalla1.openstreetmap.de"
      }
    }
  }
}

usage with Claude Desktop Local Server

{
  "mcpServers": {
    "valhalla-mcp": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/YOUR/PATH/TO/valhalla-mcp",
      "env": {
        "VALHALLA_BASE_URL": "http://localhost:8002"
      }
    }
  }
}

usage with Other MCP Clients

{
  "mcpServers": {
    "valhalla": {
      "command": "node",
      "args": ["/path/to/valhalla-mcp/dist/index.js"],
      "env": {
        "VALHALLA_BASE_URL": "https://valhalla1.openstreetmap.de"
      }
    }
  }
}

Tools

  1. route

    Single origin → destination routing with alternatives

  2. isochrone

    Travel time polygons showing reachable areas