osm-mcp-puca

osm-mcp-puca

0
location_servicesai_chatbot

osm-mcp-puca is a Model Context Protocol server designed for use with large language model chatbots, offering various tools related to OpenStreetMap. It provides functionalities such as obtaining coordinates for addresses, identifying public amenities, and calculating distances.

osm-mcp-puca

An MCP server for use with LLM chatbots providing tools related to OpenStreetMap

Usage

This MCP server can be integrated with your client that supports MCP. Púca UI Screenshot

Docker

The docker-compose.yaml file included will run both the púca UI and MCP server so that you can enter queries into the UI. To do so you will need to add your own OpenAI API Key in the .env file then start the containers with:

docker compose up -d

Check the logs for any issues and visit the web interface at http://your.ip.address:3301

Pydantic AI

See the example file client.py for how to use this MCP server with Python's pydantic_ai

Claude

Anthropic's Claude supports adding MCP servers if you edit the file:

vi ~/Library/Application\ Support/Claude/claude_desktop_config.json

adding the following but amending the URL:

{
    "mcpServers": {
      "puca": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "http://192.168.1.40:3300/sse"
          ]
        }
    }
}

Tools

Below is a list of the tools made available via the MCP server:

  • get_coordinates_for_address
  • get_address_by_coordinates
  • get_defibrillators
  • get_distance_between_addresses
  • get_distance_between_coords
  • get_parking
  • get_toilets
  • get_post_offices
  • get_cafes
  • get_fast_food_places
  • get_irish_street_names
  • get_vacant_buildings
  • get_overpass_results

Acknowledgements

This MCP server makes use of the freely available APIs from OSRM, Overpass and Nominatum. The data in OpenStreetMap is contributed by dedicated volunteers.