Ermöglicht es AI Agents, Karten, Geocoding und Zeitzonendaten mithilfe von OpenStreetMap und MapLibre in Anwendungen zu integrieren.
Auch bekannt als maprouter-dev/maprouter-mcp, maprouter-mcp
- Stars
- 0
- Tools
- 8
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.1
- Letzter Commit
- 1. Nov. 2026
- Lizenz
- MIT
Was ist MapRouter MCP?
Ermöglicht es AI Agents, Karten, Geocoding und Zeitzonendaten mithilfe von OpenStreetMap und MapLibre in Anwendungen zu integrieren. Er stellt 8 Tools bereit, etwa setup_project, geocode, reverse_geocode.
Zusammenfassung generiert aus dem README des Projekts
Über MapRouter MCP server
MapRouter bietet Entwicklern und AI Agents Tools, um Mapping, Geocoding und Zeitzonendaten in Webanwendungen zu integrieren. Es arbeitet mit OpenStreetMap und MapLibre zusammen, um funktionale Code-Snippets für Frameworks wie React, Vue, Svelte oder einfaches HTML zu generieren. Nutzer können sich über einen gehosteten HTTP transport via GitHub-Authentifizierung verbinden oder es lokal mit Node 22.18 oder neuer unter Verwendung eines Secret Keys ausführen.
Der Server enthält spezifische Tools für das Geocoding von Adressen, Reverse Geocoding und Search-as-you-type Autocomplete-Vorschläge. Er ruft zudem IANA-Zeitzoneninformationen und UTC-Offsets für bestimmte Koordinaten ab. Ein besonderes Feature ist das Prepaid-Credit-System, das es einem Agent ermöglicht, den Verbrauch zu überwachen und Budget-Limits über die Tools check_usage und set_key_budget zu senken, wobei Ausgabenlimits nicht erhöht werden können.
Entwickler können dies als eigenständigen MCP server implementieren oder als Library in Web-Standard-Umgebungen wie Deno, Bun oder Workers integrieren. Der Setup-Prozess beinhaltet das Generieren von origin-locked publishable keys und Secret Keys, um verschiedene Anwendungsbedarfe zu verwalten.
Was du damit machen kannst
- 1Interaktiven Karten-Code generierenFordere den Agent auf, MapLibre-Code inklusive Marker für ein spezifisches Web-Framework zu schreiben.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du MapRouter MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenMapRouter MCP in Claude Code installieren
$ claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcpMapRouter MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}MapRouter MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"maprouter-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}MapRouter MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"maprouter-mcp","type":"stdio","command":"npx","args":["-y","maprouter-mcp"],"env":{"MAPROUTER_SECRET_KEY":"<YOUR_MAPROUTER_SECRET_KEY>"}}'MapRouter MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}MapRouter MCP in Codex installieren
$ codex mcp add maprouter-mcp --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' -- npx -y maprouter-mcpMapRouter MCP in Codex config.toml installieren
~/.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 in Gemini CLI installieren
$ gemini mcp add -s user -e 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp npx -- -y maprouter-mcpMapRouter MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}MapRouter MCP tools 8
Erkannt aus dem READMEsetup_projectgeocodereverse_geocodeautocompletetimezoneget_map_snippetcheck_usageset_key_budget
| setup_project | — | |
| geocode | — | |
| reverse_geocode | — | |
| autocomplete | — | |
| timezone | — | |
| get_map_snippet | — | |
| check_usage | — | |
| set_key_budget | — |
Konfiguration
MAPROUTER_SECRET_KEYErforderlichSecretA secret key (mr_sk_...) from app.maprouter.dev
| Name | Beschreibung | Typ |
|---|---|---|
| MAPROUTER_SECRET_KEY | A secret key (mr_sk_...) from app.maprouter.dev | ErforderlichSecret |
Automatisierte Checks
Geluften am 12. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSBestanden
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenMapRouter 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 Fragen
Wie füge ich MapRouter MCP zu Claude Code hinzu?
Führe claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich MapRouter MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet MapRouter MCP?
Er stellt 8 Tools bereit, darunter setup_project, geocode, reverse_geocode, autocomplete, timezone.
Wie kann ich unerwartete Kosten bei der Nutzung von MapRouter vermeiden?
MapRouter ist ein Prepaid-Service, bei dem Agents den Verbrauch einsehen und Budgets senken können, aber sie können niemals Credits hinzufügen oder ein Budget erhöhen.
Welche Programmier-Frameworks kann ich nutzen, um Karten-Code zu generieren?
Der Server kann MapLibre-Code spezifisch für HTML, React, Vue oder Svelte schreiben.
Wie verbinde ich mich mit der gehosteten Version des Servers?
Du kannst den gehosteten Server über Claude via HTTP transport und die bereitgestellte URL hinzufügen.