OpenStreetMap ve MapLibre kullanarak yapay zeka ajanlarının uygulamalarına harita, geocoding ve zaman dilimi verilerini entegre etmesini sağlar.
Ayrıca bilinen adı maprouter-dev/maprouter-mcp, maprouter-mcp
- Yıldızlar
- 0
- Araçlar
- 8
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.1
- Son commit
- 1 Kas 2026
- Lisans
- MIT
MapRouter MCP nedir?
OpenStreetMap ve MapLibre kullanarak yapay zeka ajanlarının uygulamalarına harita, geocoding ve zaman dilimi verilerini entegre etmesini sağlar. 8 araç sunar; örneğin setup_project, geocode, reverse_geocode.
Özet, projenin README dosyasından oluşturuldu
MapRouter MCP sunucusu hakkında
MapRouter; geliştiricilere ve yapay zeka ajanlarına haritalama, geocoding ve zaman dilimi verilerini web uygulamalarına entegre etmeleri için araçlar sunar. React, Vue, Svelte veya düz HTML gibi frameworkler için işlevsel kod parçacıkları oluşturmak amacıyla OpenStreetMap ve MapLibre ile birlikte çalışır. Kullanıcılar, GitHub kimlik doğrulaması kullanarak hosted bir HTTP transport üzerinden bağlanabilir veya Node 22.18 veya üzerini bir secret key ile kullanarak yerel olarak çalıştırabilir.
Sunucu; adreslerin geocoding işlemi, tersine geocoding (reverse geocoding) ve yazarken arama (search-as-you-type) otomatik tamamlama önerileri sunmak için özel araçlar içerir. Ayrıca belirli koordinatlar için IANA zaman dilimi bilgilerini ve UTC farklarını getirir. Benzersiz bir özellik olarak, bir ajanın check_usage ve set_key_budget araçları aracılığıyla kullanımı izlemesine ve bütçe sınırlarını düşürmesine olanak tanıyan ancak harcama limitlerini artıramayan ön ödemeli kredi sistemi mevcuttur.
Geliştiriciler bunu bağımsız bir MCP server olarak uygulayabilir veya Deno, Bun veya Workers gibi web standartlarına uygun ortamlarda bir kütüphane olarak entegre edebilirler. Kurulum süreci, farklı uygulama ihtiyaçlarını yönetmek için origin-locked publishable key'ler ve secret key'ler oluşturmayı içerir.
Neler yapabilirsiniz
- 1Etkileşimli harita kodu oluşturmaBelirli bir web framework'ü için marker'lar içeren MapLibre kodu yazması için ajana talimat verin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
MapRouter MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleMapRouter MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcpMapRouter MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}MapRouter MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"maprouter-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}MapRouter MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"maprouter-mcp","type":"stdio","command":"npx","args":["-y","maprouter-mcp"],"env":{"MAPROUTER_SECRET_KEY":"<YOUR_MAPROUTER_SECRET_KEY>"}}'MapRouter MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}MapRouter MCP'yi Codex içine yükleyin
$ codex mcp add maprouter-mcp --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' -- npx -y maprouter-mcpMapRouter MCP'yi Codex config.toml içine yükleyin
~/.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'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp npx -- -y maprouter-mcpMapRouter MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}MapRouter MCP araçları 8
README dosyasından algılandısetup_projectgeocodereverse_geocodeautocompletetimezoneget_map_snippetcheck_usageset_key_budget
| setup_project | — | |
| geocode | — | |
| reverse_geocode | — | |
| autocomplete | — | |
| timezone | — | |
| get_map_snippet | — | |
| check_usage | — | |
| set_key_budget | — |
Yapılandırma
MAPROUTER_SECRET_KEYGerekliGizliA secret key (mr_sk_...) from app.maprouter.dev
| Ad | Açıklama | Sunucu |
|---|---|---|
| MAPROUTER_SECRET_KEY | A secret key (mr_sk_...) from app.maprouter.dev | GerekliGizli |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorGeçti
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
MapRouter 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 soruları
MapRouter MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
MapRouter MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
MapRouter MCP hangi araçları sunar?
8 araç sunar; bunlar arasında setup_project, geocode, reverse_geocode, autocomplete, timezone yer alır.
MapRouter kullanırken beklenmedik maliyetleri nasıl önleyebilirim?
MapRouter, ajanların kullanımı okuyabileceği ve bütçeyi düşürebileceği ancak kredi ekleyemeyeceği veya bütçeyi artıramayacağı ön ödemeli bir servistir.
Harita kodu oluşturmak için hangi programlama frameworklerini kullanabilirim?
Sunucu; HTML, React, Vue veya Svelte için özel olarak MapLibre kodu yazabilir.
Sunucunun hosted versiyonuna nasıl bağlanabilirim?
Hosted sunucuyu Claude üzerinden HTTP transport ve sağlanan URL aracılığıyla ekleyebilirsiniz.