mcpField
O
Opentripmap

Opentripmap

远程服务
pipeworx.io地图与出行05 周前更新

关于 Opentripmap

Opentripmap 是面向旅行规划与地点探索的 MCP 服务,可查询景点及其他地点信息。它支持按坐标搜索、地点详情、地名解析和名称联想,并可独立以 stdio 运行。

主要功能

  1. 01按坐标半径搜索兴趣点
  2. 02查询地点详情与链接
  3. 03将地名解析为坐标
  4. 04按名称前缀联想地点

适用场景

  1. 01查找城市周边的博物馆与景点
  2. 02获取某地点的地址和介绍
  3. 03将城市名转换为搜索坐标

MCP 相关

向 MCP 客户端提供 OpenTripMap 地点搜索、详情、地名解析和联想工具。可通过 Pipeworx 网关连接,也可作为本地 stdio MCP 服务运行。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://gateway.pipeworx.io/opentripmap/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

mcp-opentripmap

OpenTripMap MCP — 封装 OpenTripMap Places API(dev.opentripmap.org)

属于 Pipeworx — 一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

工具描述
opentripmap_places_radius查找某个经纬度点半径范围内的兴趣点(旅游景点、博物馆、餐厅、历史遗迹等)。返回匹配的 POI,包括 xid、名称、种类类别、与中心点的距离和坐标。示例:opentripmap_places_radius({ lat: 48.8566, lon: 2.3522, radius: 1000, kinds: "museums", limit: 20, _apiKey: "your-key" })
opentripmap_place_detail根据 OpenTripMap xid(从 opentripmap_places_radius 或 opentripmap_autosuggest 获取)获取单个地点的完整详情。返回名称、地址、类别、Wikidata/Wikipedia 链接、描述摘要、图片和网站。示例:opentripmap_place_detail({ xid: "N123456", _apiKey: "your-key" })
opentripmap_geoname将城市/地点名称解析为地理坐标和元数据(lat、lon、人口、国家、时区)。可用它将地点名称转换为 lat/lon,再传给 opentripmap_places_radius。示例:opentripmap_geoname({ name: "Paris", country: "FR", _apiKey: "your-key" })
opentripmap_autosuggest在某个经纬度点附近,对 POI 执行输入联想/部分名称搜索。按地点名称前缀在指定半径范围内匹配,适合“查找附近以 X 开头的地点”。返回匹配的 POI,包括 xid、名称、种类、距离和坐标。示例:opentripmap_autosuggest({ name: "louv", lat: 48.8566, lon: 2.3522, radius: 5000, _apiKey: "your-key" })

快速开始

添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):

{
  "mcpServers": {
    "opentripmap": {
      "url": "https://gateway.pipeworx.io/opentripmap/mcp"
    }
  }
}
此端点实际提供的内容

https://gateway.pipeworx.io/opentripmap/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/opentripmap_places_radius。查找工具:使用 {"query":"..."} 发送 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行(无需网关账户)

此软件包也可以作为本地 stdio MCP 服务运行 — 无需 Pipeworx 账户,也无需 通过网关往返:

{
  "mcpServers": {
    "opentripmap": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-opentripmap"]
    }
  }
}

或者直接运行,确认它能启动:

npx -y @pipeworx/mcp-opentripmap

它通过 stdin/stdout 使用 MCP 协议,并响应 initialize/tools/list/tools/call, 但仅限此工具包的工具 — 不包含上文网关连接额外提供的任何共享元工具。相同的源代码、相同的工具,但不包含 ask_pipeworx 路由。

与 ask_pipeworx 搭配使用

你可以用自然语言提问,而不是直接调用工具 —— 这适用于上面的工具包端点,也适用于完整网关:

ask_pipeworx({ question: "your question about Opentripmap data" })

网关会选择合适的工具并自动填写参数。

更多

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。