# Ultimaps

MCP-сервер Ultimaps, который строит хороплеты, категорийные карты и пины по названиям регионов и числам. Работает без ключа API, изображение сохраняется локально.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 у репозитория
- Автор: ultimaps
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ultimaps/mcp-server
- Обновлён: 2026-10-20
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/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.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://api.ultimaps.com/mcp`
- Переменные окружения: `ULTIMAPS_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://api.ultimaps.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env ULTIMAPS_API_KEY=<ULTIMAPS_API_KEY> --transport stdio ultimaps -- npx -y @ultimaps/mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add ultimaps --url https://api.ultimaps.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add ultimaps --env ULTIMAPS_API_KEY=<ULTIMAPS_API_KEY> -- npx -y @ultimaps/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ultimaps": {
            "url": "https://api.ultimaps.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ultimaps": {
            "command": "npx",
            "args": [
                "-y",
                "@ultimaps/mcp"
            ],
            "env": {
                "ULTIMAPS_API_KEY": "<ULTIMAPS_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "ultimaps": {
            "type": "http",
            "url": "https://api.ultimaps.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "ultimaps": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@ultimaps/mcp"
            ],
            "env": {
                "ULTIMAPS_API_KEY": "<ULTIMAPS_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http ultimaps https://api.ultimaps.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e ULTIMAPS_API_KEY=<ULTIMAPS_API_KEY> ultimaps npx -y @ultimaps/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- нарисовать хороплет штатов США по населению
- раскрасить страны ЕС по валютам
- отметить пять офисов на карте Европы
- построить карту безработицы по регионам Франции
- проверить совпадения названий регионов перед рендером

## Примеры запросов агенту
- Нарисуй карту штатов США с населением каждого
- Раскрась страны ЕС по их валютам
- Построй хороплет безработицы по округам: Калифорния — 5.2%, Техас — 4.1%, Нью-Йорк — 4.5%

## Похожие
- [matplotlib-best-practices](https://affpapa.org/nevibecode/skills/matplotlib-best-practices.md) — скилл · 1100 установок
- [maproll](https://affpapa.org/nevibecode/mcp/maproll.md) — MCP-сервер · ★ 4 у репозитория
- [globestudio](https://affpapa.org/nevibecode/skills/globestudio.md) — скилл · ★ 41430 у репозитория
- [cartography-geoviz](https://affpapa.org/nevibecode/skills/cartography-geoviz.md) — скилл · ★ 48 у репозитория
- [r-reviewer](https://affpapa.org/nevibecode/agents/r-reviewer.md) — субагент · ★ 1104 у репозитория
- [karpathy-jobs-bls-visualizer](https://affpapa.org/nevibecode/skills/karpathy-jobs-bls-visualizer.md) — скилл · 1300 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
