Terranode Geospatial API

io.github.terranode-co由 GitHub 账号 terranode-co 发布v0.1.10更新于 Oct 24, 2026

Point-in-polygon, nearest feature, spatial join, and distance tools for US geospatial datasets

已验证STDIO仅桌面位置与生活数据与分析

概览

AI 生成的概览

本地 MCP 服务器，通过 Terranode 地理空间 API 为助手提供美国地理空间查询工具：点面判断、最近要素、距离计算和空间连接。

可以做什么
列出可用的地理空间数据集，包括系统数据集和自定义数据集，让助手知道可以查询哪些数据。查询某个坐标落在哪个要素内（点面判断），例如经纬度所属的县、州或邮政编码。查找距某坐标最近的若干要素及其距离，并计算两点之间的测地距离（米和英里）。通过空间连接一次性为多个坐标补充多边形属性。
适用场景
当你希望助手基于美国数据回答位置问题时适用，例如某点属于哪个县、州或邮政编码，附近有什么，两地相距多远，或为一批坐标批量标注区域属性，而无需自己编写 API 调用。
运行要求
通过 npx 在本地运行，需要 Node.js 18 或更高版本。需要 Terranode API 密钥，通过环境变量 TERRANODE_API_KEY 提供，密钥需在提供方的应用站点注册获取。需要能访问 Terranode API 的网络，可用 TERRANODE_API_URL 覆盖基础地址。
安装前请注意
服务器需要 Terranode API 密钥，存放在环境变量 TERRANODE_API_KEY 中，请勿写入共享配置文件或代码仓库。提交的坐标会发送给第三方 Terranode API 处理。使用可能受提供方账户限额或计费约束。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Terranode Geospatial API，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@terranode-co/mcp-server

MCP server for spatial queries via the Terranode Geospatial API. Gives AI agents (Claude Desktop, Cursor, etc.) tools to query geospatial datasets — point-in-polygon lookups, nearest feature search, distance calculations, and spatial joins.

Prerequisites

Setup

Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "terranode": {      "command": "npx",      "args": ["@terranode-co/mcp-server"],      "env": {        "TERRANODE_API_KEY": "your-api-key-here"      }    }  }}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

json
{  "mcpServers": {    "terranode": {      "command": "npx",      "args": ["@terranode-co/mcp-server"],      "env": {        "TERRANODE_API_KEY": "your-api-key-here"      }    }  }}

Claude Code

Add to your Claude Code MCP settings:

json
{  "mcpServers": {    "terranode": {      "command": "npx",      "args": ["@terranode-co/mcp-server"],      "env": {        "TERRANODE_API_KEY": "your-api-key-here"      }    }  }}

Available tools

ToolDescription
list_datasetsList all available geospatial datasets (system + custom)
check_locationPoint-in-polygon: which feature contains a coordinate?
find_nearestFind the N nearest features to a coordinate, with distances
calculate_distanceGeodesic distance between two points (meters + miles)
spatial_joinEnrich multiple coordinates with polygon attributes at once

Example prompts

Try these in Claude Desktop or Cursor:

  • "What county is latitude 40.71, longitude -74.00 in?"
  • "What datasets are available?"
  • "Find the 3 nearest counties to Central Park"
  • "How close is my proposed site (40.7128, -74.006) to the nearest school (34.0522, -118.2437)?"
  • "Which states do these 5 warehouse locations fall in?" (paste coordinates)
  • "What ZIP code is 37.7749, -122.4194 in?"

API Reference

The full API spec is available at docs.terranode.co/openapi.yaml (OpenAPI 3.1).

Feedback

Report issues or feature requests: [email protected]

来源：README.md，提交 0bab79e

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.10最新Sep 16, 2026

评分

已满足适用检查项的 50%

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

  • 近 30 天内可连通25 分

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

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

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

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