Terranode Geospatial API

@terranode-co/mcp-server

用于通过 Terranode Geospatial API 进行空间查询的 MCP 服务。为 AI Agent（Claude Desktop、Cursor 等）提供查询地理空间数据集的工具，包括点位于多边形内查询、最近要素搜索、距离计算和空间连接。

前提条件

• Node.js 18+
• Terranode API 密钥——在 app.terranode.co 注册

设置

Claude Desktop

添加到你的 claude_desktop_config.json：

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

Cursor

添加到 Cursor MCP 设置（.cursor/mcp.json）：

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

Claude Code

添加到 Claude Code MCP 设置：

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

可用工具

工具	描述
list_datasets	列出所有可用的地理空间数据集（系统数据集和自定义数据集）
check_location	点位于多边形内查询：哪个要素包含指定坐标？
find_nearest	查找距离指定坐标最近的 N 个要素，并返回距离
calculate_distance	两点之间的测地线距离（米和英里）
spatial_join	一次性使用多边形属性丰富多个坐标

示例提示词

在 Claude Desktop 或 Cursor 中试试这些提示：

• “纬度 40.71、经度 -74.00 的位置属于哪个县？”
• “有哪些可用的数据集？”
• “查找距离中央公园最近的 3 个县”
• “我的拟建地点（40.7128, -74.006）距离最近的学校（34.0522, -118.2437）有多远？”
• “这 5 个仓库位置分别位于哪些州？”（粘贴坐标）
• “37.7749, -122.4194 位于哪个邮政编码区域？”

API 参考

完整的 API 规范请参阅 docs.terranode.co/openapi.yaml（OpenAPI 3.1）。

反馈

报告问题或提交功能请求：[email protected]