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 分