gitcookman avatar

Earth-2 Elevation MCP

gitcookman/earth-2-elevation-mcp

Wraps the Open-Elevation API into three local MCP tools for querying altitude data. You get single point lookups with get_elevation, batch queries for multiple coordinates with get_elevations, and get_elevation_profile which samples elevation between two points to generate a path profile. All elevations come back in meters. It hits the public Open-Elevation endpoint via POST requests and returns zero for coordinates without recorded data. Useful when you need to add topographic context to location data, calculate terrain profiles for routes, or validate elevation assumptions in mapping workflows without switching contexts.

tools
3
transport
STDIO
last updated
Jun 5, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

get_elevation查询单个经纬度的海拔,单位米。

查询单个经纬度的海拔,单位米。

No parameter schema in public metadata yet.

get_elevations批量查询多个经纬度。

批量查询多个经纬度。

No parameter schema in public metadata yet.

get_elevation_profile在两点之间均匀采样,生成路径海拔剖面。

在两点之间均匀采样,生成路径海拔剖面。

No parameter schema in public metadata yet.

Sponsors

Readme

Earth-2 Elevation MCP

本地 stdio MCP 服务,把 Open-Elevation 的海拔查询接口包装成 MCP tools。

Tools

  • get_elevation: 查询单个经纬度的海拔,单位米。
  • get_elevations: 批量查询多个经纬度。
  • get_elevation_profile: 在两点之间均匀采样,生成路径海拔剖面。

Run

npm start

也可以直接运行:

node .\src\index.js

MCP 配置示例

把下面配置加到你的 MCP client 配置里,路径按本机实际目录调整:

{
  "mcpServers": {
    "earth-2-elevation": {
      "command": "node",
      "args": [
        "D:\\coding\\AI-project\\ai-mcp-factory\\src\\index.js"
      ],
      "env": {
        "OPEN_ELEVATION_BASE_URL": "https://api.open-elevation.com"
      }
    }
  }
}

Notes

Open-Elevation 的公开接口是 POST /api/v1/lookup,请求体格式如下:

{
  "locations": [
    { "latitude": 41.161758, "longitude": -8.583933 }
  ]
}

响应会按请求顺序返回 latitude、longitude、elevation。如果没有记录到该坐标的海拔,服务会返回海平面 0 米。

Details

Repository
github.com/gitcookman/earth-2-elevation-mcp
Package
earth-2-elevation-mcp
Transport
STDIO
Registry
MCP registry, active