MapIron Maps (formerly PinSharing)

MapIron MCP

MapIron（https://mapiron.com）是一款基于 OpenStreetMap 数据构建的地图 API，提供免费套餐和固定价格的付费套餐。它提供静态地图图像（包括隐私区域模式）、地理编码和地图瓦片。本仓库为只能启动本地服务的 MCP 客户端提供轻量级的 stdio 到 HTTP 桥接。

MCP Registry：com.mapiron/maps

MapIron 在 2026 年 11 月之前名为 PinSharing。旧配置仍然有效：请参阅从 PinSharing 升级。

大多数客户端：直接使用托管服务

托管的 MCP 服务地址：

https://api.mapiron.com/v1/mcp

设置说明请参阅 https://mapiron.com/docs/mcp。使用 Claude Code：

claude mcp add --transport http mapiron https://api.mapiron.com/v1/mcp --header "Authorization: Bearer YOUR_KEY"

仅运行本地服务（stdio）的客户端

部分客户端（例如使用 claude_desktop_config.json 的 Claude Desktop）只能启动本地 stdio MCP 服务。此类客户端请使用此桥接。

{
  "mcpServers": {
    "mapiron": {
      "command": "npx",
      "args": ["-y", "github:Software-Consulting/mapiron-mcp"],
      "env": { "MAPIRON_API_KEY": "ps_your_key" }
    }
  }
}

需要 Git 和 Node.js 18+。

工具

工具	功能	计费单位
geocode	将地址或地点名称转换为坐标	1 次地理编码
reverse_geocode	将坐标转换为地址或地点	1 次地理编码
static_map	渲染带标记或路线的地图图像	1 张静态图像
privacy_area_map	显示某个地点的大致位置（以阴影区域表示，不显示图钉）；绝不透露精确位置	1 张静态图像
map_setup	交互式地图的代码和 URL（MapLibre GL JS、Leaflet、OpenLayers）	免费

配置

变量	必需	默认值	说明
MAPIRON_API_KEY	建议	无	MapIron API 密钥（ps_...）。未设置时，发现功能可用，但工具调用会返回服务器的 missing_key 错误。
MAPIRON_MCP_URL	否	https://api.mapiron.com/v1/mcp	托管 MCP 服务的 URL。必须使用 https:，除非主机是 localhost 或 127.0.0.1。
MAPIRON_MCP_TIMEOUT_MS	否	60000	HTTP 超时时间，单位为毫秒。
MAPIRON_MCP_DEBUG	否	未设置	设置为 1 可将调试日志写入 stderr。

从 PinSharing 升级

即使不做任何更改，也不会影响使用：

• github:Software-Consulting/pinsharing-mcp 会重定向到此仓库。
• 仍会读取 PINSHARING_API_KEY、PINSHARING_MCP_URL、PINSHARING_MCP_TIMEOUT_MS 和 PINSHARING_MCP_DEBUG。如果两个名称都已设置，则优先使用 MAPIRON_ 开头的变量。
• 现有的 ps_ 密钥无需更改即可继续使用，https://api.pinsharing.com/v1/mcp 也仍提供相同的工具。

要改用新名称，请将 args 中的仓库更改为 github:Software-Consulting/mapiron-mcp，并将变量重命名为 MAPIRON_API_KEY。

工作原理

桥接会从 stdin 读取 JSON-RPC 消息，每行一条，并通过 HTTPS 将每条消息转发到托管 MCP 服务。响应会写入 stdout，每行一个 JSON 对象。不会在本地存储任何内容。API 密钥仅会通过 Authorization 标头发送到配置的服务（默认为 api.mapiron.com），绝不会输出到日志或错误信息中。

套餐与限额

MapIron 设有严格的月度限额，不收取超额费用。提供无需绑定银行卡的免费套餐：

• 价格和限额：https://mapiron.com/pricing
• 免费密钥 / 控制面板：https://mapiron.com/dashboard

署名

地图数据 © OpenStreetMap 贡献者。凡是展示地图结果或图像的地方，都应显示署名信息。

开发

npm test

本项目没有任何运行时或开发依赖。

许可证

MIT。MapIron 是 Wells Software Consulting LLC 提供的服务。