🌍 geo-mcp

Геопространственный MCP-сервер, который наделяет Claude (или любой другой MCP-клиент) суперспособностями в области работы с местоположением — погода, геокодирование, часовые пояса и поиск близлежащих мест. Ключи API не требуются.

Что он делает

Подключите Claude Desktop, Cursor или любой другой MCP-клиент к актуальным геопространственным данным с помощью 5 удобных инструментов:

Все API являются бесплатными и открытыми — никакой регистрации, никаких ключей, никаких неожиданных ограничений скорости для личного использования.

Related MCP server: Simple Weather MCP

Быстрый старт

git clone https://github.com/yourname/geo-mcp
cd geo-mcp
pip install -r requirements.txt
python server.py

Запуск с помощью Docker

docker build -t geo-mcp .
docker run -p 8000:8000 geo-mcp

Подключение к Claude Desktop

Добавьте это в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "geo-mcp": {
      "command": "python",
      "args": ["/absolute/path/to/geo-mcp/server.py"]
    }
  }
}

Расположение файла конфигурации:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Перезапустите Claude Desktop — вы увидите значок инструментов 🔨.

Примеры запросов

После подключения попробуйте следующее в Claude:

What's the weather like in Tokyo right now?

Find me hospitals within 500m of the Eiffel Tower.

What time is it right now in lat 35.6762, lon 139.6503?

Geocode "1600 Pennsylvania Ave NW, Washington DC"

Структура проекта

geo-mcp/
├── server.py              # FastMCP server + tool definitions
├── adapters/
│   ├── geocoding.py       # Nominatim geocoder
│   ├── weather.py         # Open-Meteo weather
│   ├── timezone.py        # timeapi.io timezone
│   └── places.py          # Overpass POI search
├── requirements.txt
├── Dockerfile
└── claude_desktop_config.json

Справочник инструментов

geocode_address(address: str)

{
  "display_name": "Paris, Île-de-France, France",
  "lat": 48.8566,
  "lon": 2.3522,
  "type": "city"
}

current_weather(city: str)

{
  "city": "London",
  "temperature_c": 14.2,
  "feels_like_c": 12.8,
  "humidity_pct": 76,
  "wind_speed_kmh": 18.4,
  "condition": "Partly cloudy",
  "precipitation_mm": 0.0
}

places_nearby(lat, lon, category, radius_m)

Поддерживаемые категории: restaurant, cafe, hospital, pharmacy, school, supermarket, park, hotel, bank, gas_station

{
  "category": "cafe",
  "count": 8,
  "places": [
    { "name": "Monmouth Coffee", "lat": 51.513, "lon": -0.122, "opening_hours": "Mo-Fr 07:30-18:00" }
  ]
}

Почему этот проект

Создан для демонстрации паттерна мульти-адаптерного MCP — той же архитектуры, что используется в промышленных MCP-серверах для автопарков и телематики. Каждый адаптер:

• Независимо тестируется

• Легко заменяется (замените Nominatim на Google Maps, Open-Meteo на OpenWeather и т.д.)

• Асинхронный по своей сути благодаря httpx

• Типизирован с четкими схемами возвращаемых данных

Это напрямую соответствует реальным задачам MCP-серверов, требующим объединения нескольких API поставщиков под единым уровнем инструментов.

Расширение

Хотите добавить новый источник данных? Создайте adapters/yourapi.py:

import httpx

async def your_tool(param: str) -> dict:
    async with httpx.AsyncClient() as client:
        r = await client.get("https://api.example.com/...", timeout=10)
        r.raise_for_status()
        return r.json()

Затем зарегистрируйте его в server.py:

from adapters.yourapi import your_tool

@mcp.tool()
async def exposed_tool_name(param: str) -> dict:
    """Tool description shown to the AI."""
    return await your_tool(param)

Технологический стек

• FastMCP — фреймворк для MCP-серверов

• httpx — асинхронный HTTP-клиент

• Open-Meteo — бесплатный API погоды

• Nominatim — геокодирование OpenStreetMap

• Overpass API — данные POI из OpenStreetMap

• timeapi.io — поиск часовых поясов

Лицензия

MIT