Позволяет AI-агентам интегрировать карты, геокодирование и данные о часовых поясах в приложения с помощью OpenStreetMap и MapLibre.
Также известен как maprouter-dev/maprouter-mcp, maprouter-mcp
- Звёзды
- 0
- Инструменты
- 8
- Загрузки, 30 дней
- —
- Последняя версия
- 0.1.1
- Последний коммит
- 1 нояб. 2026 г.
- Лицензия
- MIT
Что такое MapRouter MCP?
Позволяет AI-агентам интегрировать карты, геокодирование и данные о часовых поясах в приложения с помощью OpenStreetMap и MapLibre. Он предоставляет 8 инструментов, например setup_project, geocode, reverse_geocode.
Сводка сгенерирована из README проекта
О MapRouter MCP server
MapRouter предоставляет разработчикам и AI-агентам инструменты для интеграции картографии, геокодирования и данных о часовых поясах в веб-приложения. Он работает с OpenStreetMap и MapLibre для генерации функциональных фрагментов кода для таких фреймворков, как React, Vue, Svelte или обычного HTML. Пользователи могут подключиться через хостинговый HTTP транспорт с использованием аутентификации GitHub или запустить его локально, используя Node 22.18 или более позднюю версию с секретным ключом.
Сервер включает специализированные инструменты для геокодирования адресов, обратного геокодирования и предоставления подсказок автозаполнения при вводе (search-as-you-type). Он также извлекает информацию о часовых поясах IANA и смещения UTC для конкретных координат. Уникальной особенностью является система предоплаты, которая позволяет агенту отслеживать использование и снижать лимиты бюджета через инструменты check_usage и set_key_budget, хотя он не может увеличивать лимиты расходов.
Разработчики могут реализовать это как автономный MCP server или интегрировать в качестве библиотеки в веб-стандартные среды, такие как Deno, Bun или Workers. Процесс настройки включает генерацию привязанных к источнику (origin-locked) публикуемых ключей и секретных ключей для управления различными потребностями приложений.
Что вы можете с ним делать
- 1Генерация кода интерактивной картыПопросите агента написать код MapLibre, включая маркеры, для конкретного веб-фреймворка.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить MapRouter MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка MapRouter MCP в Claude Code
$ claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcpУстановка MapRouter MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Установка MapRouter MCP в VS Code
.vscode/mcp.json
{
"servers": {
"maprouter-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Установка MapRouter MCP в VS Code CLI
$ code --add-mcp '{"name":"maprouter-mcp","type":"stdio","command":"npx","args":["-y","maprouter-mcp"],"env":{"MAPROUTER_SECRET_KEY":"<YOUR_MAPROUTER_SECRET_KEY>"}}'Установка MapRouter MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Установка MapRouter MCP в Codex
$ codex mcp add maprouter-mcp --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' -- npx -y maprouter-mcpУстановка MapRouter MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.maprouter-mcp] command = "npx" args = ["-y", "maprouter-mcp"] [mcp_servers.maprouter-mcp.env] MAPROUTER_SECRET_KEY = "<YOUR_MAPROUTER_SECRET_KEY>"
Установка MapRouter MCP в Gemini CLI
$ gemini mcp add -s user -e 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp npx -- -y maprouter-mcpУстановка MapRouter MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Инструменты MapRouter MCP 8
Определено из READMEsetup_projectgeocodereverse_geocodeautocompletetimezoneget_map_snippetcheck_usageset_key_budget
| setup_project | — | |
| geocode | — | |
| reverse_geocode | — | |
| autocomplete | — | |
| timezone | — | |
| get_map_snippet | — | |
| check_usage | — | |
| set_key_budget | — |
Конфигурация
MAPROUTER_SECRET_KEYОбязательноСекретA secret key (mr_sk_...) from app.maprouter.dev
| Название | Описание | Тип |
|---|---|---|
| MAPROUTER_SECRET_KEY | A secret key (mr_sk_...) from app.maprouter.dev | ОбязательноСекрет |
Автоматические проверки
Запущено 12 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетПройдено
- Удаленная конечная точка использует HTTPSПройдено
- Деструктивные инструменты помеченыПройдено
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхПройдено
README
Открыть на GitHubMapRouter MCP server
Maps your agent can set up, and a bill that can't run away.
This MCP server lets a coding agent add a working map to an app: it creates MapRouter keys, geocodes addresses, and writes MapLibre code for HTML, React, Vue or Svelte. MapRouter is prepaid, so the agent can read usage and lower budgets but can never add credits or raise a budget.
Use the hosted server (recommended)
No key to copy: it signs you in with GitHub.
claude mcp add --transport http maprouter https://mcp.maprouter.dev/mcp
Claude Code plugin
This repo is also a Claude Code plugin marketplace. The plugin adds the hosted server and an
add-a-map skill:
/plugin marketplace add maprouter-dev/maprouter-mcp
/plugin install maprouter@maprouter
Run it locally
For clients that only run local servers. (The npm package is not published yet; until then,
clone this repo and point your client at node src/stdio.ts.) Create a secret key at https://app.maprouter.dev.
{
"mcpServers": {
"maprouter": {
"command": "npx",
"args": ["-y", "maprouter-mcp"],
"env": { "MAPROUTER_SECRET_KEY": "mr_sk_..." }
}
}
}
Requires Node 22.18 or later.
Tools
| Tool | What it does | Cost |
|---|---|---|
setup_project |
Creates a publishable key (browser, origin-locked) and a secret key, returns env lines | Free |
geocode |
Address or place to coordinates | 10 credits |
reverse_geocode |
Coordinates to address | 10 credits |
autocomplete |
Search-as-you-type suggestions | 2 credits |
timezone |
IANA zone, UTC offset and DST at a point | 1 credit |
get_map_snippet |
Working MapLibre code with markers | Free |
check_usage |
Balance, free quota and key caps | Free |
set_key_budget |
Lowers a key's daily or monthly cap (never raises) | Free |
Map data © OpenStreetMap contributors.
Use it as a library
import { MapRouterClient, createServer, handleMcpRequest } from 'maprouter-mcp';
const client = new MapRouterClient({ key: process.env.MAPROUTER_SECRET_KEY! });
// Any web-standard server: Workers, Deno, Bun, Node 22+.
export default { fetch: (request: Request) => handleMcpRequest(request, client) };
Licence
MIT
Вопросы о MapRouter MCP
Как добавить MapRouter MCP в Claude Code?
Выполните claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить MapRouter MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет MapRouter MCP?
Он предоставляет 8 инструментов, включая setup_project, geocode, reverse_geocode, autocomplete, timezone.
Как предотвратить непредвиденные расходы при использовании MapRouter?
MapRouter — это сервис с предоплатой, где агенты могут отслеживать использование и снижать бюджет, но они никогда не могут добавлять кредиты или повышать бюджет.
Какие программные фреймворки можно использовать для генерации кода карт?
Сервер может писать код MapLibre специально для HTML, React, Vue или Svelte.
Как подключиться к хостинговой версии сервера?
Вы можете добавить хостинговый сервер через Claude, используя HTTP транспорт и предоставленный URL.