Ultimaps — MCP-сервер для Claude Code: карты из данных
MCP-сервер Ultimaps, который строит хороплеты, категорийные карты и пины по названиям регионов и числам. Работает без ключа API, изображение сохраняется локально.
MIT ★ 1 обновлён 2026-10-20
claude mcp add --transport http mcp https://api.ultimaps.com/mcpЧто делает Ultimaps
Агент получает инструмент render_map, который рисует карты: раскрашивает страны, штаты, округа или почтовые индексы по числам (хороплет), категориям или точным цветам, ставит пины, добавляет заголовок и легенду. Названия регионов сервер подбирает нечётко и сообщает о поправках. Дополнительные инструменты list_maps и get_map_regions дают каталог карт и списки регионов, но агенту они почти не нужны: render_map принимает названия, коды и псевдонимы напрямую.
Без ключа API работает бесплатный лимит: 30 рендеров в час, PNG до 1600 px с копирайтом. Ключ из Ultimaps Studio даёт план: бесплатный — 500 рендеров в месяц, Pro — 5000 и SVG без копирайта. Изображение возвращается в ответе, если влезает, и всегда записывается в <tmpdir>/ultimaps-mcp/. Кроме локального npm-пакета есть удалённый сервер https://api.ultimaps.com/mcp, который работает так же, но не требует Node.js.
Какие задачи решает
- нарисовать хороплет штатов США по населению
- раскрасить страны ЕС по валютам
- отметить пять офисов на карте Европы
- построить карту безработицы по регионам Франции
- проверить совпадения названий регионов перед рендером
Примеры запросов агенту
- Нарисуй карту штатов США с населением каждого
- Раскрась страны ЕС по их валютам
- Построй хороплет безработицы по округам: Калифорния — 5.2%, Техас — 4.1%, Нью-Йорк — 4.5%
Как установить Ultimaps
1Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://api.ultimaps.com/mcp2Командой платформы
claude mcp add --env ULTIMAPS_API_KEY=<ULTIMAPS_API_KEY> --transport stdio ultimaps -- npx -y @ultimaps/mcpВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add ultimaps --url https://api.ultimaps.com/mcp2Командой платформы
codex mcp add ultimaps --env ULTIMAPS_API_KEY=<ULTIMAPS_API_KEY> -- npx -y @ultimaps/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"ultimaps": {
"url": "https://api.ultimaps.com/mcp"
}
}
}{
"mcpServers": {
"ultimaps": {
"command": "npx",
"args": [
"-y",
"@ultimaps/mcp"
],
"env": {
"ULTIMAPS_API_KEY": "<ULTIMAPS_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"ultimaps": {
"type": "http",
"url": "https://api.ultimaps.com/mcp"
}
}
}{
"servers": {
"ultimaps": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ultimaps/mcp"
],
"env": {
"ULTIMAPS_API_KEY": "<ULTIMAPS_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http ultimaps https://api.ultimaps.com/mcp2Командой платформы
gemini mcp add -e ULTIMAPS_API_KEY=<ULTIMAPS_API_KEY> ultimaps npx -y @ultimaps/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы об Ultimaps
Как установить Ultimaps в Claude Code?
Команда claude mcp add --transport http ultimaps https://api.ultimaps.com/mcp добавляет удалённый сервер. Для локального с ключом используй claude mcp add --env ULTIMAPS_API_KEY=<ULTIMAPS_API_KEY> --transport stdio ultimaps -- npx -y @ultimaps/mcp.
Что делает Ultimaps?
Сервер строит карты: хороплеты (числа по регионам), категорийные (метки) и пины. Агент передаёт названия регионов и значения, сервер рисует PNG или SVG и сохраняет файл локально.
Нужен ли ключ API для работы Ultimaps?
Без ключа сервер работает с бесплатным лимитом: 30 рендеров в час, PNG до 1600 px. Ключ из Ultimaps Studio даёт месячные квоты и убирает копирайт, Pro-ключ разрешает SVG и большие размеры.