Map Canvas MCP

Встроенная интерактивная карта для хостов MCP Apps, таких как ChatGPT. Worker возвращает данные карты плюс стабильный загрузчик UI. Каждый результат инструмента выбирает контентно-адресуемый пакет Leaflet, раздаваемый через Cloudflare Static Assets, поэтому обновления интерфейса не требуют обновления неизменных метаданных инструмента. Браузер пользователя загружает видимые тайлы OpenStreetMap напрямую со стандартных тайловых серверов.

Продакшн-эндпоинт

https://map-canvas.android-mxdiego9.workers.dev/mcp

Эндпоинт является публичным и не требует аутентификации.

Related MCP server: Mapbox MCP Server

Локальная разработка

npm install
npm run check
npm run dev

npm run check выполняет проверку типов Worker и запускает дымовые тесты MCP для инициализации, обнаружения инструментов, выполнения инструментов и загрузки ресурсов виджета.

Локальный MCP-эндпоинт: http://localhost:8787/mcp. Протестируйте его с помощью MCP Inspector:

npx @modelcontextprotocol/inspector@latest

Развертывание

Разверните из терминала:

npm run deploy

Ключ API не требуется. Не добавляйте секреты в исходный код или wrangler.jsonc; используйте секреты Cloudflare, если аутентификация будет добавлена позже.

Развертывание с помощью GitHub Actions

Включенный workflow развертывается при каждом пуше в main, затем запускает продакшн-дымовой тест MCP против публичного эндпоинта. Его также можно запустить вручную со вкладки Actions. Сначала добавьте эти секреты Actions репозитория:

• CLOUDFLARE_API_TOKEN: токен с правами на редактирование Workers в целевом аккаунте

• CLOUDFLARE_ACCOUNT_ID: идентификатор целевого аккаунта Cloudflare

Значения хранятся в секретах GitHub Actions и не должны быть закоммичены в репозиторий.

Инструмент

show_map принимает 1–50 мест с десятичными координатами широты/долготы. Простые клиенты по-прежнему могут использовать connectPlaces; для туристических маршрутов также можно добавить:

• метки дня/даты и времени с фильтрацией по дням

• категории и статус подтверждено/запланировано/предварительно

• транспортные участки для пеших прогулок, автомобиля, такси, автобуса, железной дороги, парома и авиаперелетов

• схематические прямые соединения или фактическая геометрия маршрута

• проверенные ссылки на места с координатной ссылкой Google Maps в качестве запасного варианта

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

Данные карт © участники OpenStreetMap.