Skip to main content
Glama

OpenStreetMap MCP Server

MCP-сервер OpenStreetMap (OSM)

Реализация сервера OpenStreetMap MCP, которая расширяет возможности LLM с помощью сервисов на основе определения местоположения и геопространственных данных.

Демо

Оптимизация точки встречи

Вариант использования точки встречи

Анализ соседства

Пример использования анализа соседства

Поиск парковки

Пример использования поиска на парковке

Установка

В хостах MCP, таких как Claude Desktop, Cursor, Windsurf и т. д.

  • osm-mcp-server : Основной сервер, доступный для публичного использования.
    "mcpServers": { "osm-mcp-server": { "command": "uvx", "args": [ "osm-mcp-server" ] } }

Функции

Этот сервер предоставляет LLM-специалистам инструменты для взаимодействия с данными OpenStreetMap, позволяя приложениям на основе определения местоположения:

  • Геокодирование адресов и названий мест в координаты
  • Обратное геокодирование координат в адреса
  • Найти ближайшие интересные места
  • Получить указания маршрута между локациями
  • Поиск мест по категории в пределах ограничивающей рамки
  • Предложите оптимальные места встречи для нескольких человек
  • Исследуйте районы и получайте исчерпывающую информацию о местоположении
  • Найти школы и учебные заведения рядом с местом
  • Проанализируйте варианты поездок из дома на работу и обратно
  • Найдите станции зарядки электромобилей с разъемом и фильтрацией питания
  • Проведение анализа пригодности для проживания в районе недвижимости
  • Найдите парковочные места с информацией о наличии мест и стоимости

Компоненты

Ресурсы

Сервер реализует ресурсы, основанные на местоположении:

  • location://place/{query} : Получить информацию о местах по названию или адресу
  • location://map/{style}/{z}/{x}/{y} : Получить стилизованные фрагменты карты по указанным координатам

Инструменты

На сервере реализовано несколько геопространственных инструментов:

  • geocode_address : Преобразование текста в географические координаты
  • reverse_geocode : Преобразование координат в понятные человеку адреса
  • find_nearby_places : Найдите интересные места рядом с определенным местоположением
  • get_route_directions : Получить пошаговые инструкции между локациями
  • search_category : Поиск мест определенных категорий в определенном районе
  • suggest_meeting_point : Найдите оптимальные места для встреч нескольких человек
  • explore_area : Получите исчерпывающие данные о районе
  • find_schools_nearby : Найти учебные заведения рядом с определенным местом
  • analyze_commute : Сравните варианты передвижения между домом и работой
  • find_ev_charging_stations : поиск инфраструктуры зарядки электромобилей с помощью фильтрации
  • analyze_neighborhood : Оцените пригодность района для проживания в сфере недвижимости
  • find_parking_facilities : Найдите варианты парковки рядом с местом назначения

Локальное тестирование

Запуск сервера

Чтобы запустить сервер локально:

  1. Установите пакет в режиме разработки:
pip install -e .
  1. Запустите сервер:
osm-mcp-server
  1. Сервер запустится и будет прослушивать запросы MCP на стандартном вводе/выводе.

Тестирование с использованием примеров клиентов

Репозиторий включает два примера клиентов в каталоге examples/ :

Пример базового клиента

client.py демонстрирует базовое использование сервера OSM MCP:

python examples/client.py

Это позволит:

  • Подключитесь к локально работающему серверу
  • Получить информацию о Сан-Франциско
  • Поиск ресторанов в этом районе
  • Получайте комплексные картографические данные с отслеживанием прогресса
Пример интеграции LLM

llm_client.py предоставляет вспомогательный класс, предназначенный для интеграции LLM:

python examples/llm_client.py

В этом примере показано, как магистр права может использовать помощника по местоположению для:

  • Получайте информацию о местоположении из текстовых запросов
  • Найти ближайшие интересные места
  • Прокладывайте маршруты между локациями
  • Найдите оптимальные места встречи
  • Исследуйте окрестности

Написание собственного клиента

Чтобы создать собственного клиента:

  1. Импортируйте клиент MCP:
from mcp.client import Client
  1. Инициализируйте клиент с URL-адресом вашего сервера:
client = Client("http://localhost:8000")
  1. Вызов инструментов или доступ к ресурсам:
# Example: Geocode an address results = await client.invoke_tool("geocode_address", {"address": "New York City"})
Конфигурация Claude Desktop для локального сервера

В MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json В Windows: %APPDATA%/Claude/claude_desktop_config.json

"mcpServers": { "osm-mcp-server": { "command": "uv", "args": [ "--directory", "/path/to/osm-mcp-server", "run", "osm-mcp-server" ] } }

Разработка

Строительство и издательское дело

Чтобы подготовить пакет к распространению:

  1. Синхронизируем зависимости и обновляем файл блокировки:
uv sync
  1. Сборка дистрибутивов пакетов:
uv build

Это создаст исходный код и дистрибутивы wheel в каталоге dist/ .

  1. Опубликовать в PyPI:
uv publish

Примечание: вам необходимо будет задать учетные данные PyPI с помощью переменных среды или флагов команд.

Отладка

Поскольку серверы MCP работают через stdio, отладка может быть сложной. Для лучшего опыта отладки мы настоятельно рекомендуем использовать MCP Inspector .

Вы можете запустить MCP Inspector через npm с помощью этой команды:

npx @modelcontextprotocol/inspector uv --directory /path/to/osm-mcp-server run osm-mcp-server

После запуска Инспектор отобразит URL-адрес, к которому вы можете перейти в своем браузере, чтобы начать отладку.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Расширяет возможности LLM с помощью сервисов на основе определения местоположения и геопространственных данных, позволяя пользователям геокодировать адреса, находить близлежащие объекты интереса, получать маршруты, оптимизировать места встреч и анализировать окрестности.

  1. Демо
    1. Оптимизация точки встречи
    2. Анализ соседства
    3. Поиск парковки
  2. Установка
    1. В хостах MCP, таких как Claude Desktop, Cursor, Windsurf и т. д.
  3. Функции
    1. Компоненты
      1. Ресурсы
      2. Инструменты
    2. Локальное тестирование
      1. Запуск сервера
      2. Тестирование с использованием примеров клиентов
      3. Написание собственного клиента
    3. Разработка
      1. Строительство и издательское дело
      2. Отладка

    Related MCP Servers

    • -
      security
      A
      license
      -
      quality
      Enables integration with DuckDuckGo search capabilities for LLMs, supporting comprehensive web search, regional filtering, result types, and safe browsing with caching and customizable search parameters.
      Last updated -
      26
      2
      TypeScript
      MIT License
    • A
      security
      A
      license
      A
      quality
      Enables LLMs to perform travel-related tasks by interacting with Google Maps and travel planning services including location search, place details, and travel time calculations.
      Last updated -
      5
      36
      21
      JavaScript
      MIT License
    • -
      security
      F
      license
      -
      quality
      Enables interaction with lightning addresses and common lightning tools via your LLM, providing Lightning Network functionality through natural language.
      Last updated -
      15
      1
      TypeScript
    • -
      security
      F
      license
      -
      quality
      Enables LLMs to interact with DataForSEO and other SEO APIs through natural language, allowing for keyword research, SERP analysis, backlink analysis, and local SEO tasks.
      Last updated -
      1,008
      38
      TypeScript

    View all related MCP servers

    MCP directory API

    We provide all the information about MCP servers via our MCP API.

    curl -X GET 'https://glama.ai/api/mcp/v1/servers/jagan-shanmugam/open-streetmap-mcp'

    If you have feedback or need assistance with the MCP directory API, please join our Discord server