osm-mcp-puca

Name: osm-mcp-puca
Author: jonnymccullagh

@jonnymccullagh

リポジトリ

osm-mcp-puca について

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

基本情報

カテゴリ

その他

ライセンス

GPL-3.0

ランタイム

python

トランスポート

stdio

公開者

jonnymccullagh

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

get_address_by_coordinates

get_distance_between_addresses

get_parking

get_post_offices

get_fast_food_places

get_vacant_buildings

概要

What is osm-mcp-puca?

osm-mcp-puca is an MCP server designed for use with LLM chatbots, providing tools related to OpenStreetMap. It is for developers and users who want to query OpenStreetMap data via natural language interfaces.

How to use osm-mcp-puca?

Integrate the server with any MCP‑compatible client. For Docker, add an OpenAI API Key to .env and run docker compose up -d, then visit http://your.ip.address:3301. For Claude, edit claude_desktop_config.json to include the server’s SSE endpoint. For Python, see the example client.py using Pydantic AI.

Key features of osm-mcp-puca

Tools to query OpenStreetMap data via MCP
Get coordinates from addresses and vice versa
Find amenities: defibrillators, parking, toilets, post offices, cafes, fast food
Calculate distances between addresses or coordinates
Fetch Irish street names and vacant buildings
Custom Overpass API query results

Use cases of osm-mcp-puca

Ask a chatbot for the nearest defibrillator or cafe using natural language
Get driving or walking distance between two addresses
Look up the postal address for a set of GPS coordinates
Find vacant buildings in a specific area
Explore Irish street names through conversational queries

FAQ from osm-mcp-puca

What data sources does osm-mcp-puca use?

It uses the freely available APIs from OSRM (routing), Overpass (querying), and Nominatim (geocoding), all backed by OpenStreetMap volunteer-contributed data.

Does osm-mcp-puca require an API key?

Yes, when running via Docker you must add your own OpenAI API Key in the .env file. No key is mentioned for the other integrations.

What tools are included?

The server exposes 13 tools: 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, and get_overpass_results.

Can I use osm-mcp-puca with Claude Desktop?

Yes, by adding the server to Claude’s MCP configuration with the command npx mcp-remote http://<your-ip>:3300/sse.

Is there a web interface?

Yes, the included Púca UI runs on port 3301 via Docker Compose, allowing direct query entry.

「その他」の他のコンテンツ

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K