maproll — MCP-сервер для Claude Code: карты из URL
Даёт ассистенту собрать статическую карту из ваших данных и вернуть её как постоянный URL, который можно вставить в README или дашборд.
claude mcp add maproll -- npx -y @maproll/mcpЧто делает maproll
maproll — MCP-сервер, который превращает данные в карту и отдаёт её ссылкой. Числовые значения дают choropleth, цвета закрашивают регионы, текстовые — качественные группы. Регионы задаются кодами ISO 3166-1 alpha-2 на мировом масштабе (US, DE, BR) и ISO 3166-2 внутри страны (RO-B, RO-CJ).
Внутри четыре инструмента. create_map строит карту из данных, add_layers добавляет маркеры, маршруты, круги и подписи к уже готовой карте, find_places переводит название места в координаты и id, а describe_options показывает, какие темы, иконки и проекции рендерер принимает. Данные передаются структурой — грамматику URL сервер держит на себе, вручную собирать строки не нужно.
Каждый вызов возвращает PNG для просмотра и svg_url — постоянную ссылку, которая и есть карта. Она же служит входом для следующего изменения, так что карту можно достраивать за несколько шагов. Нужен Node 20 или новее; ключ API не требуется, но без него на карте остаётся вотермарк maproll. Ключ из редактора убирает его, живёт 90 дней, и после истечения опубликованные вставки снова получают вотермарк — это повод проверить дату выпуска ключа заранее. Атрибуция OpenStreetMap остаётся в любом случае.
Какие задачи решает
- собрать карту потребления из таблицы и получить ссылку
- нанести морские маршруты через Суэц и Панамский канал
- подсветить страны ЕС на светлой карте
- достроить готовую карту маркерами за несколько шагов
- вставить карту в README без JavaScript
Примеры запросов агенту
- Построй карту потребления кофе на душу населения для десяти крупнейших стран-потребителей.
- Нарисуй морской маршрут из Шанхая в Роттердам и отметь оба порта.
- Добавь на эту карту маркеры аэропортов и верни ссылку для вставки.
Как установить maproll
Командой платформы
claude mcp add maproll -- npx -y @maproll/mcpКомандой платформы
codex mcp add maproll -- npx -y @maproll/mcpФайл настроек
{
"mcpServers": {
"maproll": {
"command": "npx",
"args": [
"-y",
"@maproll/mcp"
]
}
}
}Файл настроек
{
"servers": {
"maproll": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@maproll/mcp"
]
}
}
}Командой платформы
gemini mcp add maproll npx -y @maproll/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о maproll
Как установить maproll в Claude Code?
Одной командой: claude mcp add maproll -- npx -y @maproll/mcp.
Что делает maproll?
Собирает статические карты из ваших данных и возвращает их как URL: svg_url для вставки, png_url для картинки, editor_url для правки в редакторе.
Нужен ли ключ API?
Карты работают без аккаунта, но с вотермарком maproll. Ключ MAPROLL_API_KEY убирает его; ключи истекают через 90 дней, и тогда вставки снова показывают вотермарк.
