mcp-server

mcp-server

mapboxMIT
342 звёзд37 форков
Сервер, который подключает AI-ассистентов к геоданным Mapbox. Он реализует Model Context Protocol и даёт инструменты для работы с адресами, картами, маршрутами и пространственным анализом. Разработчики используют его, чтобы научить AI понимать, где что находится, как добраться и что доступно в заданном радиусе. Сервер решает задачи логистики, туристических сервисов, городских приложений и любых проектов с привязкой к местности. Он берёт на себя интеграцию с API Mapbox: геокодирование, поиск точек интереса, построение маршрутов, расчёт изохрон и генерацию карт. Всё это доступно через единый MCP-интерфейс. Благодаря offline-расчётам часть операций выполняется без обращения к сети — это ускоряет работу и снижает зависимость от API.
Search
Открыть на GitHub

Установка

npx -y @mapbox/mcp-server

Характеристики

Общее

  • СтатусСообщество
  • Разработчикmapbox
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    streamable-httpstdio

Описание

Возможности

  • Преобразовывать адреса и названия мест в географические координаты и обратно (прямое и обратное геокодирование)
  • Искать точки интереса (POI) по всему миру: магазины, рестораны, аптеки, достопримечательности
  • Строить маршруты для автомобиля, пешехода и велосипеда с учётом текущего трафика
  • Рассчитывать матрицу расстояний и времени между несколькими точками для анализа доступности
  • Оптимизировать порядок посещения нескольких точек, чтобы сократить общий путь (задача коммивояжёра)
  • Приводить GPS-треки к дорожной сети — превращать «сырые» координаты в ровные маршруты
  • Создавать изохроны — зоны, которые можно достичь за указанное время или расстояние на выбранном транспорте
  • Генерировать статические изображения карт с нанесёнными точками, маршрутами и областями
  • Выполнять пространственные вычисления без обращения к API: измерять расстояние, площадь, азимут, строить буферные зоны

Как подключить

Для работы нужен токен Mapbox. Зарегистрируйтесь на mapbox.com/signup и создайте токен в личном кабинете.

Есть два способа подключения: локальный запуск через npx и облачный эндпоинт Mapbox.

Локальный запуск

1. Выполните команду:
npx -y @mapbox/mcp-server

2. Добавьте конфигурацию в настройки MCP-клиента. Пример для Claude Desktop:

{ "mcpServers": { "mapbox": { "command": "npx", "args": ["-y", "@mapbox/mcp-server"], "env": { "MAPBOX_ACCESS_TOKEN": "ваш_токен_доступа" } } } }

3. После добавления конфигурации перезапустите клиент.

Облачный эндпоинт

Используйте адрес https://mcp.mapbox.com/mcp. В некоторых клиентах нужно указать URL и передать токен через параметры или заголовки. Подробности — в документации Mapbox.

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

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

Технические детали

  • Язык: TypeScript
  • Транспорт: streamable-http, stdio
  • Лицензия: MIT
  • Разработчик: Mapbox
  • Звёзды на GitHub: 342
  • Совместимые клиенты: Claude Desktop, VS Code, любые MCP-совместимые приложения

Поделиться