Permite que los agentes de IA integren mapas, geocodificación y datos de zonas horarias en aplicaciones utilizando OpenStreetMap y MapLibre.
También conocido como maprouter-dev/maprouter-mcp, maprouter-mcp
- Stars
- 0
- Herramientas
- 8
- Descargas, 30 días
- —
- Última versión
- 0.1.1
- Último commit
- 1 nov 2026
- Licencia
- MIT
¿Qué es MapRouter MCP?
Permite que los agentes de IA integren mapas, geocodificación y datos de zonas horarias en aplicaciones utilizando OpenStreetMap y MapLibre. Expone 8 herramientas, como setup_project, geocode, reverse_geocode.
Resumen generado a partir del README del proyecto
Acerca del MCP server de MapRouter
MapRouter proporciona a desarrolladores y agentes de IA herramientas para integrar mapas, geocodificación y datos de zonas horarias en aplicaciones web. Funciona con OpenStreetMap y MapLibre para generar fragmentos de código funcionales para frameworks como React, Vue, Svelte o HTML puro. Los usuarios pueden conectarse mediante un transporte HTTP alojado usando la autenticación de GitHub o ejecutarlo localmente usando Node 22.18 o posterior con una clave secreta.
El servidor incluye herramientas específicas para la geocodificación de direcciones, geocodificación inversa y sugerencias de autocompletado mientras se escribe. También recupera información de zonas horarias IANA y desplazamientos UTC para coordenadas específicas. Una característica única es el sistema de créditos prepago que permite a un agente monitorear el uso y reducir los límites de presupuesto mediante las herramientas check_usage y set_key_budget, aunque no puede aumentar los límites de gasto.
Los desarrolladores pueden implementar esto como un MCP server independiente o integrarlo como una librería dentro de entornos estándar de la web como Deno, Bun o Workers. El proceso de configuración incluye la generación de claves publicables vinculadas al origen y claves secretas para gestionar las diferentes necesidades de la aplicación.
Qué puedes hacer con él
- 1Generar código de mapas interactivosPide al agente que escriba código de MapLibre que incluya marcadores para un framework web específico.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar MapRouter MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar MapRouter MCP en Claude Code
$ claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcpInstalar MapRouter MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Instalar MapRouter MCP en VS Code
.vscode/mcp.json
{
"servers": {
"maprouter-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Instalar MapRouter MCP en 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>"}}'Instalar MapRouter MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Instalar MapRouter MCP en Codex
$ codex mcp add maprouter-mcp --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' -- npx -y maprouter-mcpInstalar MapRouter MCP en 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>"
Instalar MapRouter MCP en Gemini CLI
$ gemini mcp add -s user -e 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp npx -- -y maprouter-mcpInstalar MapRouter MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Herramientas de MapRouter MCP 8
Detectado desde el READMEsetup_projectgeocodereverse_geocodeautocompletetimezoneget_map_snippetcheck_usageset_key_budget
| setup_project | — | |
| geocode | — | |
| reverse_geocode | — | |
| autocomplete | — | |
| timezone | — | |
| get_map_snippet | — | |
| check_usage | — | |
| set_key_budget | — |
Configuración
MAPROUTER_SECRET_KEYObligatorioSecretoA secret key (mr_sk_...) from app.maprouter.dev
| Nombre | Descripción | Tipo |
|---|---|---|
| MAPROUTER_SECRET_KEY | A secret key (mr_sk_...) from app.maprouter.dev | ObligatorioSecreto |
Verificaciones automáticas
Ejecutado 12 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSAprobado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en 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
Preguntas sobre MapRouter MCP
¿Cómo agrego MapRouter MCP a Claude Code?
Ejecuta claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego MapRouter MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona MapRouter MCP?
Expone 8 herramientas, incluidas setup_project, geocode, reverse_geocode, autocomplete, timezone.
¿Cómo puedo evitar costos inesperados al usar MapRouter?
MapRouter es un servicio prepago donde los agentes pueden consultar el uso y reducir los presupuestos, pero nunca pueden añadir créditos ni aumentar un presupuesto.
¿Qué frameworks de programación puedo usar para generar código de mapas?
El servidor puede escribir código de MapLibre específicamente para HTML, React, Vue o Svelte.
¿Cómo me conecto a la versión alojada del servidor?
Puedes añadir el servidor alojado a través de Claude usando el transporte HTTP y la URL proporcionada.