关于 MapRouter
MapRouter 是面向编码 Agent 的 MCP 服务,可协助在应用中添加地图,并提供地理编码、时区查询和 MapLibre 代码片段。预付费额度由 Agent 可查看和降低,但不能充值或提高预算。
主要功能
- 01创建发布密钥和机密密钥
- 02正向与反向地理编码
- 03地点自动补全与时区查询
- 04生成 MapLibre 代码片段
- 05查看用量并降低密钥预算
适用场景
- 01为应用添加 MapLibre 地图
- 02将地址转换为坐标
- 03查询地点的时区
MCP 相关
通过托管 HTTP 端点或本地运行的服务,向 MCP 客户端提供地图和密钥管理工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://mcp.maprouter.dev/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http dev-maprouter https://mcp.maprouter.dev/mcpCursor.cursor/mcp.json
{"mcpServers":{"dev-maprouter":{"type":"http","url":"https://mcp.maprouter.dev/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"dev-maprouter":{"type":"http","url":"https://mcp.maprouter.dev/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"dev-maprouter":{"type":"http","url":"https://mcp.maprouter.dev/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"dev-maprouter":{"serverUrl":"https://mcp.maprouter.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
MapRouter MCP 服务
可由你的 Agent 配置的地图,以及一笔无法失控的账单。
这个 MCP 服务可让编码 Agent 为应用添加可用的地图:创建 MapRouter 密钥、对地址进行地理编码,并生成适用于 HTML、React、Vue 或 Svelte 的 MapLibre 代码。MapRouter 采用预付费模式,因此 Agent 可以读取用量并降低预算,但绝不能充值或提高预算。
使用托管服务(推荐)
无需复制密钥:使用 GitHub 登录。
claude mcp add --transport http maprouter https://mcp.maprouter.dev/mcp
Claude Code 插件
此仓库也是 Claude Code 插件市场。该插件会添加托管服务和一个 add-a-map 技能:
/plugin marketplace add maprouter-dev/maprouter-mcp
/plugin install maprouter@maprouter
在本地运行
适用于只能运行本地服务的客户端。(npm 包尚未发布;在此之前,请克隆此仓库,并将客户端指向 node src/stdio.ts。)在 https://app.maprouter.dev 创建一个密钥。
{
"mcpServers": {
"maprouter": {
"command": "npx",
"args": ["-y", "maprouter-mcp"],
"env": { "MAPROUTER_SECRET_KEY": "mr_sk_..." }
}
}
}
需要 Node 22.18 或更高版本。
工具
| 工具 | 功能 | 费用 |
|---|---|---|
setup_project | 创建可发布密钥(浏览器端,锁定来源)和密钥,并返回环境变量行 | 免费 |
geocode | 将地址或地点转换为坐标 | 10 点数 |
reverse_geocode | 将坐标转换为地址 | 10 点数 |
autocomplete | 输入时即时提供搜索建议 | 2 点数 |
timezone | 返回指定位置的 IANA 时区、UTC 偏移量和夏令时信息 | 1 点数 |
get_map_snippet | 提供带标记的可用 MapLibre 代码 | 免费 |
check_usage | 查询余额、免费额度和密钥上限 | 免费 |
set_key_budget | 降低密钥的每日或每月上限(绝不提高) | 免费 |
地图数据 © OpenStreetMap 贡献者。
将其用作库
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) };
许可证
MIT
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。