World Port Index

@pipeworx/world-port-index

全球约 2,950 个港口的港口设施、水深、锚地和航海详情——支持按名称／UN-LOCODE／WPI 编号查询、按纬度／经度坐标点搜索指定半径内的港口，以及按国家／地区列出港口。

属于 Pipeworx——一个将 AI Agent 连接到 1808+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联，未获其认可，也并非由其发布。

工具

• port_lookup(name | unlocode | wpi_number) — 查找一个港口并返回其 WPI 编号、坐标、港口规模／类型、航道／锚地／货运码头水深，以及设施标记（引航、拖船、干船坞、铁路）。若没有匹配项，则返回错误；若名称匹配多个港口，则返回简短的候选列表。
• ports_near(latitude, longitude, radius_km?, limit?) — 查找指定坐标点一定半径内的港口，按距离从近到远排列，并附带以 km 为单位的距离。
• ports_by_country(country, harbor_size?, limit?) — 列出某个国家／地区的港口（国家／地区名称或 ISO 3166-1 alpha-2 代码），也可按港口规模筛选（V=非常小，S=小，M=中，L=大）。

身份验证

无需密钥。此工具包从 Pipeworx 侧的存储读取数据集（见下文“数据来源”），请求时不会发出外部调用。

数据来源

• 美国国家地理空间情报局（NGA），海事安全信息，《世界港口索引》（Pub. 150）——全球港口设施、水深和航海特征的标准参考资料。美国联邦政府数据；属于公有领域。

此工具包不会将数据内置到网关程序包中——早期版本曾这样做，而内置的 1.7MB 表格使网关的 JS 程序包超出硬性大小上限，导致所有 lane 的部署受阻（fleet #3061，2026-10-14）。取而代之的是，请求时从共享的 pipeworx-datasets R2 存储桶读取一个 JSON 对象，并将其缓存在 Worker 隔离实例内存中数小时，因此只有冷启动的隔离实例需要执行读取。scripts/refresh-ports.mjs 会获取 NGA 的实时数据源、进行精简并在本地写入该对象；拥有 R2 写入权限的操作员运行脚本打印的 wrangler r2 object put 命令即可发布该对象（此脚本本身绝不会运行该命令）。如果尚未发布该 R2 对象，或部署中未配置绑定，所有工具都会返回 available: false 提示，而不会抛出异常或静默返回空结果。每个实际响应都带有 data_as_of。水深字段（channelDepth、anchorageDepth、cargoPierDepth、oilTerminalDepth）以 NGA 发布的米为单位；null 表示 NGA 未记录该类别的数据，而非水深为零。harborTypeCode 和 shelterCode 会原样保留为 NGA 自己的 Pub 150 代码，而不进行解码，因为只有港口规模代码（V/S/M/L）具有明确且文档完备的映射关系。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "world-port-index": {
      "url": "https://gateway.pipeworx.io/world-port-index/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/world-port-index/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 都会连接到同一个网关和相同的 1808+ 个数据源。唯一的区别是哪些工具包的工具会被直接列出；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/port_lookup \
  -H 'Content-Type: application/json' \
  -d '{"name":"Rotterdam"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/port_lookup。查找工具包：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经由网关往返：

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

或者直接运行，以确认服务能够启动：

npx -y @pipeworx/mcp-world-port-index

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不包含上述网关连接所附加的共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

除了直接调用工具，你也可以用自然语言提问——这既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about World Port Index data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT