PinSharing Maps

com.pinsharing由 pinsharing.com 发布官方发布者v1.0.2更新于 Nov 5, 2026

Geocoding, static maps and privacy-safe area maps from OpenStreetMap data. Hard caps, no overage.

已验证Streamable HTTP可网页运行位置与生活媒体与设计

概览

AI 生成的概览

PinSharing Maps 是基于 OpenStreetMap 数据的托管 MCP 服务器，让助手进行地理编码并生成静态地图或隐私区域地图图片。

可以做什么
  • 把地址或地名转换为坐标，也可把坐标反查为地址或地点
  • 生成带标记或路线的静态地图图片
  • 生成隐私区域地图，只显示大致范围而不暴露精确点位
  • 获取 MapLibre GL JS、Leaflet 或 OpenLayers 交互式地图的代码与链接
适用场景
适合需要把地址转成坐标、在地图图片上标注地点或路线，或只展示大致位置而不暴露精确点的场景。也适合在对话或文档流程中直接获得地图图像，而无需自行搭建地图服务。
运行要求
需要可访问的远程 MCP 端点 api.pinsharing.com（HTTPS）。需要 PinSharing API 密钥（ps_...），以 bearer 形式放在 Authorization 请求头中，可在控制台获取免费密钥。只能启动本地 stdio 服务器的客户端需使用配套桥接程序，要求 Git 和 Node.js 18 以上。
安装前请注意
API 密钥属于凭据，请勿写入共享配置或日志。工具调用会按地理编码次数和静态图片张数计入每月额度，额度用尽不会自动超额计费。地图结果和图片出现处需标注 OpenStreetMap 署名。请求会发送给第三方服务 api.pinsharing.com。

安装

在 SourceWeft 中

  1. 打开 控制台中的 PinSharing Maps，将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.pinsharing%2Fmaps/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "pinsharing-maps": {
      "type": "http",
      "url": "https://api.pinsharing.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

PinSharing MCP

PinSharing (https://pinsharing.com) is a map API built on OpenStreetMap data, with a free plan and flat paid plans. It provides static map images, including a privacy-area mode, geocoding, and tiles. This repository provides a small stdio-to-HTTP bridge for MCP clients that can only launch local servers.

MCP Registry: com.pinsharing/maps

Most clients: use the hosted server directly

The hosted MCP server is available at:

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

See https://pinsharing.com/docs/mcp for setup. With Claude Code:

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

Clients that only run local servers (stdio)

Some clients, such as Claude Desktop with claude_desktop_config.json, can only launch local stdio MCP servers. For those, use this bridge.

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

Git and Node.js 18+ are required. An npm package (@pinsharing/mcp) is coming.

Tools

ToolWhat it doesWhat it counts
geocodeConvert addresses or place names to coordinates1 geocode
reverse_geocodeConvert coordinates to an address or place1 geocode
static_mapRender a map image with markers or a route1 static image
privacy_area_mapShow roughly where a place is (a shaded area, no pin); never reveals the exact point1 static image
map_setupCode and URLs for an interactive map (MapLibre GL JS, Leaflet, OpenLayers)free

Configuration

VariableRequiredDefaultDescription
PINSHARING_API_KEYRecommendednonePinSharing API key (ps_...). Without it, discovery works and tool calls return the server's missing_key error.
PINSHARING_MCP_URLNohttps://api.pinsharing.com/v1/mcpHosted MCP server URL. Must be https: unless the host is localhost or 127.0.0.1.
PINSHARING_MCP_TIMEOUT_MSNo60000HTTP timeout in milliseconds.
PINSHARING_MCP_DEBUGNounsetSet to 1 to write debug logs to stderr.

How it works

The bridge reads JSON-RPC messages from stdin, one per line, and forwards each one to the hosted MCP server over HTTPS. Responses are written to stdout, one JSON object per line. Nothing is stored locally. The API key is only sent to api.pinsharing.com in the Authorization header, and never printed in logs or errors.

Plans and caps

PinSharing has hard monthly caps and no overage billing. A free plan is available without a card:

Attribution

Map data © OpenStreetMap contributors. Show attribution wherever map results or images appear.

Development

bash
npm test

The project has zero runtime or development dependencies.

License

MIT. PinSharing is a service of Wells Software Consulting LLC.

来源：README.md，提交 d5e94d1

工具

0
该服务器需要 API 密钥等凭据，因此 SourceWeft 无法在没有凭据的情况下读取其工具，也未收录。

版本历史

2
  1. v1.0.2最新Nov 5, 2026
  2. v1.0.0Nov 5, 2026

评分

已满足适用检查项的 60%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分