openstreetmap-mcp-server — MCP-сервер для Claude Code: обзор
MCP-сервер для прямого и обратного геокодинга, поиска объектов и выполнения запросов Overpass API к OpenStreetMap. Работает через HTTP или stdio.
claude mcp add --transport http openstreetmap-mcp-server https://openstreetmap.caseyjhand.com/mcpЧто делает openstreetmap-mcp-server
Сервер предоставляет шесть инструментов для взаимодействия с базами данных Nominatim и Overpass API. Он умеет выполнять прямой геокодинг по названию или отдельным полям адреса, обратный поиск по координатам и выборку объектов по их OSM ID с префиксами N, W или R. Если готовых параметров недостаточно, инструмент openstreetmap_query_raw принимает произвольные запросы Overpass QL с объёмом выдачи до 256 MiB.
Для пространственного анализа предусмотрены поиск в радиусе до 50000 метров и фильтрация внутри прямоугольных границ либо полигонов. Теги сопоставляются как точным совпадением, так и по элементам списков со значением через точку с запятой. Результаты сортируются по расстоянию от исходной точки.
Запустить сервер можно через публичный эндпоинт https://openstreetmap.caseyjhand.com/mcp либо локально командой npx. Для собственного развёртывания обязательно нужен корректный OSM_USER_AGENT, иначе запросы к Nominatim будут отклонены.
Какие задачи решает
- найти координаты объекта по адресу или детальным полям расположения
- определить адрес и ближайшие ориентиры по широте и долготе
- выгрузить заведения определённого типа в радиусе вокруг заданной точки
- выполнить пространственный запрос на языке Overpass QL
- получить адресные записи объектов OSM по списку их идентификаторов
Примеры запросов агенту
- Найди координаты и почтовый индекс для центральной площади в Берлине через openstreetmap_search_places.
- Выведи все кофейни в радиусе 1000 метров от координат 52.5200, 13.4050.
- Сделай запрос через openstreetmap_query_raw, чтобы получить границы парков внутри города.
Как установить openstreetmap-mcp-server
1Командой платформы: удалённый сервер
claude mcp add --transport http openstreetmap-mcp-server https://openstreetmap.caseyjhand.com/mcp2Командой платформы
claude mcp add --env OSM_NOMINATIM_BASE_URL=<OSM_NOMINATIM_BASE_URL> --env OSM_USER_AGENT=<OSM_USER_AGENT> --env OSM_OVERPASS_BASE_URL=<OSM_OVERPASS_BASE_URL> --env OSM_OVERPASS_ENDPOINTS=<OSM_OVERPASS_ENDPOINTS> --env OSM_OVERPASS_MAX_CONCURRENCY=<OSM_OVERPASS_MAX_CONCURRENCY> --transport stdio openstreetmap-mcp-server -- npx -y @cyanheads/openstreetmap-mcp-serverВместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
1Командой платформы: удалённый сервер
codex mcp add openstreetmap-mcp-server --url https://openstreetmap.caseyjhand.com/mcp2Командой платформы
codex mcp add openstreetmap-mcp-server --env OSM_NOMINATIM_BASE_URL=<OSM_NOMINATIM_BASE_URL> --env OSM_USER_AGENT=<OSM_USER_AGENT> --env OSM_OVERPASS_BASE_URL=<OSM_OVERPASS_BASE_URL> --env OSM_OVERPASS_ENDPOINTS=<OSM_OVERPASS_ENDPOINTS> --env OSM_OVERPASS_MAX_CONCURRENCY=<OSM_OVERPASS_MAX_CONCURRENCY> -- npx -y @cyanheads/openstreetmap-mcp-serverВместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"openstreetmap-mcp-server": {
"url": "https://openstreetmap.caseyjhand.com/mcp"
}
}
}{
"mcpServers": {
"openstreetmap-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/openstreetmap-mcp-server"
],
"env": {
"OSM_NOMINATIM_BASE_URL": "<OSM_NOMINATIM_BASE_URL>",
"OSM_USER_AGENT": "<OSM_USER_AGENT>",
"OSM_OVERPASS_BASE_URL": "<OSM_OVERPASS_BASE_URL>",
"OSM_OVERPASS_ENDPOINTS": "<OSM_OVERPASS_ENDPOINTS>",
"OSM_OVERPASS_MAX_CONCURRENCY": "<OSM_OVERPASS_MAX_CONCURRENCY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"openstreetmap-mcp-server": {
"type": "http",
"url": "https://openstreetmap.caseyjhand.com/mcp"
}
}
}{
"servers": {
"openstreetmap-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/openstreetmap-mcp-server"
],
"env": {
"OSM_NOMINATIM_BASE_URL": "<OSM_NOMINATIM_BASE_URL>",
"OSM_USER_AGENT": "<OSM_USER_AGENT>",
"OSM_OVERPASS_BASE_URL": "<OSM_OVERPASS_BASE_URL>",
"OSM_OVERPASS_ENDPOINTS": "<OSM_OVERPASS_ENDPOINTS>",
"OSM_OVERPASS_MAX_CONCURRENCY": "<OSM_OVERPASS_MAX_CONCURRENCY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
1Командой платформы: удалённый сервер
gemini mcp add -t http openstreetmap-mcp-server https://openstreetmap.caseyjhand.com/mcp2Командой платформы
gemini mcp add -e OSM_NOMINATIM_BASE_URL=<OSM_NOMINATIM_BASE_URL> -e OSM_USER_AGENT=<OSM_USER_AGENT> -e OSM_OVERPASS_BASE_URL=<OSM_OVERPASS_BASE_URL> -e OSM_OVERPASS_ENDPOINTS=<OSM_OVERPASS_ENDPOINTS> -e OSM_OVERPASS_MAX_CONCURRENCY=<OSM_OVERPASS_MAX_CONCURRENCY> openstreetmap-mcp-server npx -y @cyanheads/openstreetmap-mcp-serverВместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о openstreetmap-mcp-server
Как установить openstreetmap-mcp-server в Claude Code?
Подключить удалённый HTTP-сервер можно командой claude mcp add --transport http openstreetmap-mcp-server https://openstreetmap.caseyjhand.com/mcp. Для локального запуска через stdio используйте `claude mcp add --env OSM_NOMINATIM_BASE_URL=<OSM_NOMINATIM_BASE_URL> --env OSM_USER_AGENT=<OSM_USER_AGENT> --env OSM_OVERPASS_BASE_URL=<OSM_OVERPASS_BASE_URL> --env OSM_OVERPASS_ENDPOINTS=<OSM_OVERPASS_ENDPOINTS> --env OSM_OVERPASS_MAX_CONCURRENCY=<OSM_OVERPASS_MAX_CONCURRENCY> --transport stdio openstreetmap-mcp-server -- npx -y @cyanheads/openstreetmap-mcp-server`.
Что делает openstreetmap-mcp-server?
Он связывает ассистента с сервисами Nominatim и Overpass API. Сервер позволяет искать адреса, преобразовывать координаты в названия мест и собирать объекты карты по тегам.
Какие лимиты действуют на выборки объектов?
Поиск в окрестностях ограничен радиусом 50000 метров, а выдача возвращает до 500 элементов на страницу. При поиске по идентификаторам за один вызов обрабатывается до 50 уникальных ID, остальные возвращаются в списке отложенных.
