Permet aux agents IA d'intégrer des cartes, du géocodage et des données de fuseaux horaires dans des applications en utilisant OpenStreetMap et MapLibre.
Aussi connu sous maprouter-dev/maprouter-mcp, maprouter-mcp
- Étoiles
- 0
- Outils
- 8
- Téléchargements, 30 jours
- —
- Dernière version
- 0.1.1
- Dernier commit
- 1 nov. 2026
- Licence
- MIT
Qu'est-ce que MapRouter MCP ?
Permet aux agents IA d'intégrer des cartes, du géocodage et des données de fuseaux horaires dans des applications en utilisant OpenStreetMap et MapLibre. Il expose 8 outils, comme setup_project, geocode, reverse_geocode.
Résumé généré à partir du README du projet
À propos du MCP server MapRouter
MapRouter fournit aux développeurs et aux agents IA des outils pour intégrer la cartographie, le géocodage et les données de fuseaux horaires dans des applications web. Il fonctionne avec OpenStreetMap et MapLibre pour générer des extraits de code fonctionnels pour des frameworks tels que React, Vue, Svelte ou du HTML pur. Les utilisateurs peuvent se connecter via un transport HTTP hébergé en utilisant l'authentification GitHub ou l'exécuter localement avec Node 22.18 ou une version ultérieure à l'aide d'une clé secrète.
Le serveur inclut des outils spécifiques pour le géocodage d'adresses, le géocodage inversé et la fourniture de suggestions d'autocomplétion de type recherche prédictive. Il récupère également les informations de fuseau horaire IANA et les décalages UTC pour des coordonnées spécifiques. Une fonctionnalité unique est le système de crédits prépayés qui permet à un agent de surveiller l'utilisation et d'abaisser les plafonds budgétaires via les outils check_usage et set_key_budget, bien qu'il ne puisse pas augmenter les limites de dépenses.
Les développeurs peuvent implémenter cela en tant que MCP server autonome ou l'intégrer comme une bibliothèque au sein d'environnements conformes aux standards web tels que Deno, Bun ou Workers. Le processus de configuration inclut la génération de clés publiables liées à l'origine et de clés secrètes pour gérer les différents besoins des applications.
Ce que vous pouvez faire avec
- 1Générer du code de carte interactiveDemandez à l'agent d'écrire du code MapLibre incluant des marqueurs pour un framework web spécifique.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer MapRouter MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller MapRouter MCP dans Claude Code
$ claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcpInstaller MapRouter MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Installer MapRouter MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"maprouter-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Installer MapRouter MCP dans 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>"}}'Installer MapRouter MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Installer MapRouter MCP dans Codex
$ codex mcp add maprouter-mcp --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' -- npx -y maprouter-mcpInstaller MapRouter MCP dans 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>"
Installer MapRouter MCP dans Gemini CLI
$ gemini mcp add -s user -e 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp npx -- -y maprouter-mcpInstaller MapRouter MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Outils MCP MapRouter 8
Détectés depuis le READMEsetup_projectgeocodereverse_geocodeautocompletetimezoneget_map_snippetcheck_usageset_key_budget
| setup_project | — | |
| geocode | — | |
| reverse_geocode | — | |
| autocomplete | — | |
| timezone | — | |
| get_map_snippet | — | |
| check_usage | — | |
| set_key_budget | — |
Configuration
MAPROUTER_SECRET_KEYRequisSecretA secret key (mr_sk_...) from app.maprouter.dev
| Nom | Description | Type |
|---|---|---|
| MAPROUTER_SECRET_KEY | A secret key (mr_sk_...) from app.maprouter.dev | RequisSecret |
Vérifications automatisées
Exécuté le 12 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSRéussi
- Les outils destructifs sont étiquetésRéussi
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesRéussi
README
Voir sur 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
Questions sur MapRouter MCP
Comment ajouter MapRouter MCP à Claude Code ?
Exécutez claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter MapRouter MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils MapRouter MCP fournit-il ?
Il expose 8 outils, dont setup_project, geocode, reverse_geocode, autocomplete, timezone.
Comment puis-je éviter des coûts imprévus en utilisant MapRouter ?
MapRouter est un service prépayé où les agents peuvent consulter leur consommation et abaisser leurs budgets, mais ils ne peuvent jamais ajouter de crédits ni augmenter un budget.
Quels frameworks de programmation puis-je utiliser pour générer du code de cartographie ?
Le serveur peut écrire du code MapLibre spécifiquement pour HTML, React, Vue ou Svelte.
Comment me connecter à la version hébergée du serveur ?
Vous pouvez ajouter le serveur hébergé via Claude en utilisant le transport HTTP et l'URL fournie.