Terranode Geospatial API
Point-in-polygon, nearest feature, spatial join, and distance tools for US geospatial datasets
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
@terranode-co/mcp-serverclaude mcp add terranode-geospatial-api -e 'TERRANODE_API_KEY=<your terranode_api_key>' -e 'TERRANODE_API_URL=https://api.terranode.co' -- npx -y @terranode-co/mcp-server@0.1.10
{
"mcpServers": {
"terranode-geospatial-api": {
"command": "npx",
"args": [
"-y",
"@terranode-co/mcp-server@0.1.10"
],
"env": {
"TERRANODE_API_KEY": "<your terranode_api_key>",
"TERRANODE_API_URL": "https://api.terranode.co"
}
}
}
}
متغيرات البيئة
TERRANODE_API_KEYإلزامي سري API key from app.terranode.coTERRANODE_API_URLAPI base URL (defaults to https://api.terranode.co)
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
@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
- Node.js 18+
- A Terranode API key — sign up at app.terranode.co
Setup
Claude Desktop
Add to your claude_desktop_config.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):
{
"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:
{
"mcpServers": {
"terranode": {
"command": "npx",
"args": ["@terranode-co/mcp-server"],
"env": {
"TERRANODE_API_KEY": "your-api-key-here"
}
}
}
}
Available tools
| Tool | Description |
|---|---|
list_datasets | List all available geospatial datasets (system + custom) |
check_location | Point-in-polygon: which feature contains a coordinate? |
find_nearest | Find the N nearest features to a coordinate, with distances |
calculate_distance | Geodesic distance between two points (meters + miles) |
spatial_join | Enrich 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: feedback@terranode.co
الأسئلة الشائعة
ما هو Terranode Geospatial API؟
Point-in-polygon, nearest feature, spatial join, and distance tools for US geospatial datasets
كيف أثبّت Terranode Geospatial API؟
يعمل على جهازك. في Claude Code: claude mcp add terranode-geospatial-api -e 'TERRANODE_API_KEY=<your terranode_api_key>' -e 'TERRANODE_API_URL=https://api.terranode.co' -- npx -y @terranode-co/mcp-server@0.1.10. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Terranode Geospatial API إلى مفتاح API؟
نعم. يتطلب TERRANODE_API_KEY، وتضبطها في إعداداته.
هل Terranode Geospatial API مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Terranode Geospatial API؟
ينشره terranode-co. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.