Memungkinkan AI agent untuk mengintegrasikan peta, geocoding, dan data zona waktu ke dalam aplikasi menggunakan OpenStreetMap dan MapLibre.
Juga dikenal sebagai maprouter-dev/maprouter-mcp, maprouter-mcp
- Stars
- 0
- Tools
- 8
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.1.1
- Commit terakhir
- 1 Nov 2026
- Lisensi
- MIT
Apa itu MapRouter MCP?
Memungkinkan AI agent untuk mengintegrasikan peta, geocoding, dan data zona waktu ke dalam aplikasi menggunakan OpenStreetMap dan MapLibre. Server ini menyediakan 8 tool, seperti setup_project, geocode, reverse_geocode.
Ringkasan dibuat dari README proyek
Tentang MapRouter MCP server
MapRouter menyediakan tools bagi developer dan AI agent untuk mengintegrasikan data pemetaan, geocoding, dan zona waktu ke dalam aplikasi web. Tool ini bekerja dengan OpenStreetMap dan MapLibre untuk menghasilkan snippet kode fungsional untuk framework seperti React, Vue, Svelte, atau HTML biasa. Pengguna dapat terhubung melalui hosted HTTP transport menggunakan autentikasi GitHub atau menjalankannya secara lokal menggunakan Node 22.18 atau versi terbaru dengan secret key.
Server ini menyertakan tools khusus untuk geocoding alamat, melakukan reverse geocoding, dan menyediakan saran autocomplete search-as-you-type. Selain itu, server ini juga mengambil informasi zona waktu IANA dan offset UTC untuk koordinat tertentu. Fitur uniknya adalah sistem credit prabayar yang memungkinkan agent untuk memantau penggunaan dan menurunkan batas budget melalui tools check_usage dan set_key_budget, meskipun agent tidak dapat meningkatkan limit pengeluaran.
Developer dapat mengimplementasikan ini sebagai MCP server standalone atau mengintegrasikannya sebagai library di dalam lingkungan web-standard seperti Deno, Bun, atau Workers. Proses setup mencakup pembuatan publishable keys yang terkunci pada origin tertentu serta secret keys untuk mengelola berbagai kebutuhan aplikasi.
Apa yang bisa Anda lakukan dengannya
- 1Generate kode peta interaktifMinta agent untuk menulis kode MapLibre termasuk marker untuk framework web tertentu.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal MapRouter MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal MapRouter MCP di Claude Code
$ claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcpInstal MapRouter MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Instal MapRouter MCP di VS Code
.vscode/mcp.json
{
"servers": {
"maprouter-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Instal MapRouter MCP di 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>"}}'Instal MapRouter MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Instal MapRouter MCP di Codex
$ codex mcp add maprouter-mcp --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' -- npx -y maprouter-mcpInstal MapRouter MCP di 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>"
Instal MapRouter MCP di Gemini CLI
$ gemini mcp add -s user -e 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp npx -- -y maprouter-mcpInstal MapRouter MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}Tool MapRouter MCP 8
Terdeteksi dari READMEsetup_projectgeocodereverse_geocodeautocompletetimezoneget_map_snippetcheck_usageset_key_budget
| setup_project | — | |
| geocode | — | |
| reverse_geocode | — | |
| autocomplete | — | |
| timezone | — | |
| get_map_snippet | — | |
| check_usage | — | |
| set_key_budget | — |
Konfigurasi
MAPROUTER_SECRET_KEYWajibRahasiaA secret key (mr_sk_...) from app.maprouter.dev
| Nama | Deskripsi | Tipe |
|---|---|---|
| MAPROUTER_SECRET_KEY | A secret key (mr_sk_...) from app.maprouter.dev | WajibRahasia |
Pengecekan otomatis
Berjalan 12 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauLolos
- Lisensi open source (OSI)Lolos
- Ada commit atau release dalam satu tahun terakhirLolos
- Nama package tidak mirip dengan package populerLolos
- Remote endpoint menggunakan HTTPSLolos
- Tools yang bersifat destruktif telah diberi labelLolos
- Tidak ada instruksi tersembunyi untuk modelLolos
- Tidak ada advisory kritis pada paket atau dependensinyaLolos
README
Lihat di 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
Pertanyaan tentang MapRouter MCP
Bagaimana cara menambahkan MapRouter MCP ke Claude Code?
Jalankan claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan MapRouter MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan MapRouter MCP?
Server ini menyediakan 8 tool, termasuk setup_project, geocode, reverse_geocode, autocomplete, timezone.
Bagaimana cara mencegah biaya tak terduga saat menggunakan MapRouter?
MapRouter adalah layanan prabayar di mana agent dapat membaca penggunaan dan menurunkan budget, tetapi mereka tidak akan pernah bisa menambah credit atau menaikkan budget.
Framework pemrograman apa yang bisa saya gunakan untuk membuat kode peta?
Server ini dapat menulis kode MapLibre khusus untuk HTML, React, Vue, atau Svelte.
Bagaimana cara terhubung ke versi hosted dari server ini?
Anda dapat menambahkan hosted server melalui Claude menggunakan HTTP transport dan URL yang telah disediakan.