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»).

NPM package @terranode-co/mcp-server
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 (Claude Desktop وCursor وVS Code)
{
    "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.co
  • TERRANODE_API_URL API base URL (defaults to https://api.terranode.co)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @terranode-co/mcp-server
  2. Prerequisites
  3. Setup
  4. Available tools
  5. Example prompts
  6. API Reference
  7. Feedback

@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:

{
  "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

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: 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 الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.