OpenStreetMapとMapLibreを使用して、地図、ジオコーディング、およびタイムゾーンデータをアプリケーションに統合できます。
別名 maprouter-dev/maprouter-mcp, maprouter-mcp
- スター
- 0
- ツール
- 8
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.1.1
- 最終コミット
- 2026年11月1日
- ライセンス
- MIT
MapRouter MCPとは
OpenStreetMapとMapLibreを使用して、地図、ジオコーディング、およびタイムゾーンデータをアプリケーションに統合できます。 8個のツールを提供しており、setup_project, geocode, reverse_geocodeなどがあります。
プロジェクトのREADMEから生成された概要
MapRouter MCP server について
MapRouterは、開発者やAIエージェントが地図、ジオコーディング、およびタイムゾーンデータをWebアプリケーションに統合するためのツールを提供します。OpenStreetMapおよびMapLibreと連携し、React、Vue、Svelte、または標準的なHTMLなどのフレームワーク向けに、機能的なコードスニペットを生成します。ユーザーは、GitHub認証を使用したホスト型HTTPトランスポート経由で接続するか、Node 22.18以降を使用してローカルで実行できます。
このMCP serverには、住所のジオコーディング、逆ジオコーディング、および入力中の検索候補を表示するオートコンプリート機能のための専用ツールが含まれています。また、特定の座標に対するIANAタイムゾーン情報とUTCオフセットを取得することも可能です。ユニークな機能としてプリペイドクレジットシステムがあり、エージェントは check_usage および set_key_budget ツールを通じて、使用状況の監視や予算上限の引き下げを行うことができますが、支出制限を引き上げることはできません。
開発者は、これをスタンドアロンのMCP serverとして実装するか、Deno、Bun、WorkersなどのWeb標準環境内でライブラリとして統合できます。セットアッププロセスには、さまざまなアプリケーションのニーズを管理するための、オリジン制限付きの公開可能キーおよびシークレットキーの生成が含まれます。
できること
- 1インタラクティブな地図コードの生成特定のWebフレームワーク向けに、マーカーを含むMapLibreコードをエージェントに記述させます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
MapRouter MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにMapRouter MCPをインストール
$ claude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcpCursorにMapRouter MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}VS CodeにMapRouter MCPをインストール
.vscode/mcp.json
{
"servers": {
"maprouter-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}VS Code CLIにMapRouter MCPをインストール
$ code --add-mcp '{"name":"maprouter-mcp","type":"stdio","command":"npx","args":["-y","maprouter-mcp"],"env":{"MAPROUTER_SECRET_KEY":"<YOUR_MAPROUTER_SECRET_KEY>"}}'Claude DesktopにMapRouter MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}CodexにMapRouter MCPをインストール
$ codex mcp add maprouter-mcp --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' -- npx -y maprouter-mcpCodex config.tomlにMapRouter MCPをインストール
~/.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>"
Gemini CLIにMapRouter MCPをインストール
$ gemini mcp add -s user -e 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp npx -- -y maprouter-mcpGemini settings.jsonにMapRouter MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"maprouter-mcp": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<YOUR_MAPROUTER_SECRET_KEY>"
}
}
}
}MapRouter MCPツール 8
READMEから検出setup_projectgeocodereverse_geocodeautocompletetimezoneget_map_snippetcheck_usageset_key_budget
| setup_project | — | |
| geocode | — | |
| reverse_geocode | — | |
| autocomplete | — | |
| timezone | — | |
| get_map_snippet | — | |
| check_usage | — | |
| set_key_budget | — |
設定
MAPROUTER_SECRET_KEY必須シークレットA secret key (mr_sk_...) from app.maprouter.dev
| 名前 | 説明 | 種類 |
|---|---|---|
| MAPROUTER_SECRET_KEY | A secret key (mr_sk_...) from app.maprouter.dev | 必須シークレット |
自動チェック
実行日 2026年11月12日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用合格
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見る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のよくある質問
MapRouter MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'MAPROUTER_SECRET_KEY=<YOUR_MAPROUTER_SECRET_KEY>' maprouter-mcp -- npx -y maprouter-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
MapRouter MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
MapRouter MCPが提供するツールは
8個のツールを提供しており、setup_project, geocode, reverse_geocode, autocomplete, timezoneなどがあります。
MapRouterを使用する際、予期しないコストを防ぐにはどうすればよいですか?
MapRouterはプリペイド方式のサービスです。エージェントは使用状況を確認し、予算を下げることができますが、クレジットを追加したり予算を引き上げたりすることはできません。
地図コードを生成するために、どのプログラミングフレームワークを使用できますか?
このMCP serverは、HTML、React、Vue、またはSvelte専用のMapLibreコードを記述できます。
ホスト版のサーバーに接続するにはどうすればよいですか?
HTTPトランスポートと提供されたURLを使用して、Claudeからホストされたサーバーを追加できます。