关于 Radar
Radar 是面向需要位置数据的应用和 Agent 的 MCP 服务,可通过 Radar API 提供地理编码、地点搜索、IP 定位和坐标上下文信息。
主要功能
- 01地址和地点自动补全
- 02正向与反向地理编码
- 03IP 地址定位
- 04地点与地理围栏上下文
适用场景
- 01根据部分地址推荐地点
- 02转换地址与坐标
- 03根据 IP 地址估算位置
MCP 相关
通过网关端点或本地 stdio 服务向 MCP 客户端提供 Radar 位置工具。网关端点还会列出 Pipeworx 的共享元工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/radar/mcpclaude mcp add --transport http pipeworx-io-radar https://gateway.pipeworx.io/radar/mcp{"mcpServers":{"pipeworx-io-radar":{"type":"http","url":"https://gateway.pipeworx.io/radar/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-radar":{"type":"http","url":"https://gateway.pipeworx.io/radar/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-radar":{"type":"http","url":"https://gateway.pipeworx.io/radar/mcp"}}}{"mcpServers":{"pipeworx-io-radar":{"serverUrl":"https://gateway.pipeworx.io/radar/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
mcp-radar
Radar MCP — 封装 Radar 地理编码 / 搜索 API(radar.com)
属于 Pipeworx — 一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。
工具
| 工具 | 描述 |
|---|---|
radar_autocomplete | 使用 Radar 根据部分文本自动补全地址/地点。返回按相关性排序的地址/地点建议及坐标。可选择将结果偏向某个 lat,lng 附近。示例:radar_autocomplete({ query: "841 broadway new", near: "40.73,-73.99", apiKey: "prj_live_sk..." }) |
radar_geocode | 使用 Radar 将地址地理编码为坐标(正向地理编码)。返回最佳匹配的格式化地址及纬度/经度。示例:radar_geocode({ query: "841 Broadway, New York, NY", apiKey: "prj_live_sk..." }) |
radar_reverse_geocode | 使用 Radar 将坐标反向地理编码为地址。返回 lat/lng 对应的格式化地址。示例:radar_reverse_geocode({ lat: 40.70390, lon: -73.98670, apiKey: "prj_live_sk..." }) |
radar_ip_geocode | 使用 Radar 将 IP 地址定位到城市/州/国家及大致坐标。省略 ip 可定位调用方。示例:radar_ip_geocode({ ip: "8.8.8.8", apiKey: "prj_live_sk..." }) |
radar_context | 使用 Radar 获取坐标对应的地点/地理围栏/区域上下文。返回 geofence、坐标所在地点,以及行政区域(国家/州/邮政编码)。示例:radar_context({ lat: 40.70390, lon: -73.98670, apiKey: "prj_live_sk..." }) |
快速开始
添加到 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"radar": {
"url": "https://gateway.pipeworx.io/radar/mcp"
}
}
}
此端点实际提供的内容
https://gateway.pipeworx.io/radar/mcp 上的 tools/list 会返回上表中的工具,以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此,你看到的工具数量会多于此表:单个工具包端点目前会在该工具包自身的工具之外,列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围,也是当天适用范围的权威信息。
这是有意为之,并非意外复用。元工具可以让限定范围的连接回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——而无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点;如果额外的架构所占用的上下文成本高于路由带来的收益,请连接一次完整网关,而不是连接多个工具包端点。
你也可以连接到完整的 Pipeworx 网关,直接获取所有工具包列出的工具,而不只是此工具包的工具:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
这两个 URL 都连接到同一网关和同样的 1683+ 个数据源。唯一的区别在于直接列出的是哪个工具包的工具;无论连接哪一个,ask_pipeworx 都能访问所有工具。
没有 MCP 客户端?通过 HTTP 调用
此工具包需要使用你自己的 API 密钥(_apiKey)——我们不会代为提供,因此这里没有无需密钥即可运行的 curl 命令。查看任意工具:GET https://gateway.pipeworx.io/v1/tools/radar_autocomplete。查找工具:向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求,并使用 {"query":"..."}。
独立运行(无需网关账户)
此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户,也无需往返网关:
{
"mcpServers": {
"radar": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-radar"]
}
}
}
或者直接运行,确认服务能够启动:
npx -y @pipeworx/mcp-radar
它通过 stdin/stdout 进行 MCP 通信,并对 initialize/tools/list/tools/call 作出响应,仅提供此工具包的工具——不包含上文网关连接额外提供的共享元工具。相同的源码,相同的工具,不提供 ask_pipeworx 路由。
使用 ask_pipeworx
你可以用简单的英文提问,而不是直接调用工具——此方式既适用于上文的工具包端点,也适用于完整网关:
ask_pipeworx({ question: "your question about Radar data" })
网关会选择合适的工具并自动填写参数。
More
License
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。