MCP Server
Ask Claude or another assistant for a place in plain words and get the Terrain Viewer view in the conversation, through a server it can call
Paste this in the Claude desktop app to install it and start:
Set up the Terrain Viewer MCP server on this computer. Clone https://github.com/Iconem/terrain-viewer, run
pnpm installat its root and again in itsmcpfolder, thenpnpm buildinmcp. Add it to my Claude Desktop configuration file (claude_desktop_config.json, undermcpServers) asterrain-viewer, with the commandnodeand the arguments<path of the clone>/mcp/server.mjsand--stdio. Keep what the file already holds. Tell me when to restart Claude. After the restart I will ask: show me the slope of the terrain around the Matterhorn in 3D.
It needs git, Node 20 or later, pnpm and Google Chrome on the computer. Claude runs the commands and asks before each one unless you allowed them. After the restart, ask in your own words; no tool has to be named.
The skill teaches an assistant to write a link. The server goes further: the assistant can look things up (where a place is, which datasets cover it, which dated images exist) and the result shows in the conversation.
What you can ask
- "Show me the slope of the terrain around the Matterhorn in 3D."
- "I am looking for ancient earthworks in the forest of the Veluwe. Which elevation data is best there, and show it so they stand out."
- "Which satellite images exist over Antakya after the February 2023 earthquake? Show the most recent."
- "Compare the surface model and the ground model over Amsterdam."
- "How high is the Matterhorn above Zermatt, and how steep is the line between them?"
- "Give me a GeoTIFF of the elevation around Mont Blanc."
Tools
| Tool | What it does |
|---|---|
open_view | A place and modes, shown in the conversation, with the link that opens it |
compare_sources | One place twice, side by side or as an overlay: two terrain datasets, or the imagery of two dates |
geocode | A place name to coordinates (OpenStreetMap) |
datasets_covering | The terrain datasets of the library that cover a point, finest first, and the imagery catalogs that have something there |
catalog_items | Dated satellite and aerial images and old maps for an area, from the catalogs the timeline reads |
imagery_dates | The capture dates of the built-in dated imagery at a place: Esri Wayback and Google Earth historical |
search_stac | Items of any STAC API or static catalog over an area |
elevation | The height of points, or a profile along a line, on one or several datasets |
export_geotiff | The elevation of an area as a GeoTIFF file (32-bit float, EPSG:3857) |
screenshot | A picture of a view, so the assistant can look at the terrain itself |
elevation and export_geotiff read tile datasets (Mapterhorn, AWS, Terrarium and Terrain-RGB pyramids). A dataset served as a COG, a WMS or a VRT is read by the app alone: the assistant opens it with open_view, and its Download section exports it.
By hand
git clone https://github.com/Iconem/terrain-viewer
cd terrain-viewer && pnpm install
cd mcp && pnpm install && pnpm buildClaude Desktop: Settings, Developer, Edit Config, then restart the app.
{
"mcpServers": {
"terrain-viewer": { "command": "node", "args": ["/path/to/terrain-viewer/mcp/server.mjs", "--stdio"] }
}
}Claude Code:
claude mcp add terrain-viewer -- node /path/to/terrain-viewer/mcp/server.mjs --stdioclaude.ai and ChatGPT reach a server by its address, not on your computer: run pnpm start in mcp (it listens on http://localhost:3300/mcp), put it behind a public HTTPS address, and add that address as a custom connector.
What shows in the conversation
Three displays, picked by what the view needs and what the host allows, with buttons to switch:
- Interactive map: a map drawn in the conversation itself, to pan, zoom and tilt. It draws hillshade, 3D terrain and satellite imagery on the tile datasets. A view that needs nothing else opens this way.
- Exact picture: the view with every mode asked for (slope, local relief model, sky-view factor, dated imagery, a split), rendered by the server in a few seconds. A view that needs the app's computed modes opens this way, with the interactive map one click away.
- Live app: the app itself, in its embed layout. Claude frames a website inside a conversation only for some connectors: never for a server that runs on your computer, and for a server reached by its address only after you allow the site, in organizations where the feature is on (Claude's documentation).
Open in the browser always opens the full app, at the place the interactive map was moved to.
The server's own notes, with the files and what was tested, are in mcp/README.md.