Metadata-Version: 2.4
Name: geospatial-mcp-server
Version: 0.1.0
Summary: Geospatial MCP Server — Geocoding, POI-Suche, Routing und Gebietsstatistiken via OpenStreetMap fuer AI Agents
Project-URL: Homepage, https://github.com/AiAgentKarl/geospatial-mcp-server
Project-URL: Repository, https://github.com/AiAgentKarl/geospatial-mcp-server
Project-URL: Issues, https://github.com/AiAgentKarl/geospatial-mcp-server/issues
Author: AiAgentKarl
License: MIT
License-File: LICENSE
Keywords: ai-agents,geocoding,geospatial,mcp,nominatim,openstreetmap,osm,overpass
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# geospatial-mcp-server

<!-- mcp-name: geospatial-mcp-server -->

MCP Server for geospatial data — gives AI agents access to geocoding, reverse geocoding, POI search, routing info, and area statistics via OpenStreetMap.

**100% free, no API key required.** Uses OpenStreetMap Nominatim + Overpass API.

## Tools

| Tool | Description |
|------|-------------|
| `geocode` | Convert address/place name to coordinates |
| `reverse_geocode` | Convert coordinates to address |
| `search_nearby` | Find POIs nearby (restaurants, hospitals, schools, etc.) |
| `get_route_info` | Distance and bearing between two points |
| `get_area_stats` | Population, area, type info for a place |
| `find_boundaries` | Administrative boundaries of a place |
| `search_pois` | Search points of interest by keyword in an area |

## Installation

```bash
pip install geospatial-mcp-server
```

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "geospatial": {
      "command": "geospatial-server"
    }
  }
}
```

Or with uvx (no install needed):

```json
{
  "mcpServers": {
    "geospatial": {
      "command": "uvx",
      "args": ["geospatial-mcp-server"]
    }
  }
}
```

## Examples

- "Where is the Eiffel Tower?" → `geocode("Eiffel Tower, Paris")`
- "What's at 48.8566, 2.3522?" → `reverse_geocode(48.8566, 2.3522)`
- "Find restaurants near me" → `search_nearby(48.8566, 2.3522, "restaurant")`
- "How far is Berlin from Munich?" → `get_route_info("Berlin", "Munich")`
- "Tell me about Tokyo" → `get_area_stats("Tokyo")`

## Data Sources

- [OpenStreetMap Nominatim](https://nominatim.openstreetmap.org/) — Geocoding & reverse geocoding
- [Overpass API](https://overpass-api.de/) — POI search & spatial queries

## License

MIT
