OpenStreetMap과 MapLibre를 사용하여 AI agent가 지도, 지오코딩 및 시간대 데이터를 애플리케이션에 통합할 수 있도록 지원합니다.
다른 이름 maprouter-dev/maprouter-mcp, maprouter-mcp
- 스타
- 0
- Tools
- 8
- 다운로드, 30일
- —
- 최신 버전
- 0.1.1
- 마지막 커밋
- 2026년 11월 1일
- 라이선스
- MIT
MapRouter MCP란?
OpenStreetMap과 MapLibre를 사용하여 AI agent가 지도, 지오코딩 및 시간대 데이터를 애플리케이션에 통합할 수 있도록 지원합니다. 8개 도구를 제공합니다. 예: setup_project, geocode, reverse_geocode.
프로젝트 README에서 생성된 요약
MapRouter MCP server 정보
MapRouter는 개발자와 AI agent가 지도, 지오코딩 및 시간대 데이터를 웹 애플리케이션에 통합할 수 있는 도구를 제공합니다. OpenStreetMap 및 MapLibre와 연동하여 React, Vue, Svelte 또는 일반 HTML과 같은 프레임워크용 기능적 코드 스니펫을 생성합니다. 사용자는 GitHub 인증을 사용하는 호스팅된 HTTP transport를 통해 연결하거나, Node 22.18 이상 버전에서 secret key를 사용하여 로컬에서 실행할 수 있습니다.
이 server에는 주소 지오코딩, 역지오코딩 수행, 타이핑 시 검색 자동 완성 제안을 제공하는 특정 도구들이 포함되어 있습니다. 또한 특정 좌표에 대한 IANA 시간대 정보와 UTC 오프셋을 가져옵니다. 독특한 기능으로는 선불 크레딧 시스템이 있어, agent가 check_usage 및 set_key_budget 도구를 통해 사용량을 모니터링하고 예산 한도를 낮출 수 있지만, 지출 한도를 늘릴 수는 없습니다.
개발자는 이를 독립적인 MCP server로 구현하거나 Deno, Bun, Workers와 같은 웹 표준 환경 내에서 라이브러리로 통합할 수 있습니다. 설정 과정에는 다양한 애플리케이션 요구 사항을 관리하기 위한 origin-locked publishable key 및 secret key 생성이 포함됩니다.
활용 사례
- 1대화형 지도 코드 생성특정 웹 프레임워크용 마커가 포함된 MapLibre 코드를 작성하도록 agent에게 요청하세요.
프로젝트의 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
MapRouter MCP는 어떤 도구를 제공하나요?
8개 도구를 제공합니다. 예: setup_project, geocode, reverse_geocode, autocomplete, timezone.
MapRouter 사용 시 예상치 못한 비용 발생을 어떻게 방지할 수 있나요?
MapRouter는 선불 서비스입니다. agent는 사용량을 확인하고 예산 한도를 낮출 수는 있지만, 크레딧을 추가하거나 예산을 높일 수는 없습니다.
지도 코드를 생성할 때 어떤 프로그래밍 프레임워크를 사용할 수 있나요?
이 MCP server는 HTML, React, Vue 또는 Svelte 전용 MapLibre 코드를 작성할 수 있습니다.
호스팅된 버전의 server에 어떻게 연결하나요?
HTTP transport와 제공된 URL을 사용하여 Claude에서 호스팅된 server를 추가할 수 있습니다.