# cesium-mcp-runtime

cesium-mcp-runtime — an MCP server for controlling an interactive 3D map via CesiumJS. Gives AI agents 59 tools: camera control, layer management, entities, animation, and geocoding.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 6000 installs
- Author: gaopengbin
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/gaopengbin/cesium-mcp-runtime
- Updated: 2026-03-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/gaopengbin-cesium-mcp-runtime

## What it does

cesium-mcp-runtime extends Claude Code, Cursor, and other IDEs by integrating with CesiumJS. The server exposes tools for 3D globe work: flying to coordinates, adding GeoJSON layers, markers, polylines and polygons, heat map visualization, and 3D model placement (glTF/GLB). It handles complex workflows — trajectory animation, orbital camera motion, live entity updates, 3D Tiles and terrain loading.

The server runs over HTTP via endpoint `https://cesium-mcp-runtime--gaopengbin.run.tools` and supports multiple transport types: stdio for Claude Desktop and VS Code, HTTP Streamable for Dify, n8n and custom backends. Multi-browser session routing, tool filtering, and Cesium Ion asset loading are built in.

Tools span camera (`flyTo`, `setView`, `lookAtTransform`), layers (`addGeoJsonLayer`, `setLayerVisibility`, `updateLayerStyle`), entities (`addMarker`, `addPolygon`, `addModel`, `updateEntity`), animation (`playTrajectory`, `createAnimation`), and utilities (`listLayers`, `getView`, `screenshot` as base64 PNG). Agents require a live connection to the endpoint.

## Requirements
- Remote server: `https://cesium-mcp-runtime--gaopengbin.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http cesium-mcp-runtime https://cesium-mcp-runtime--gaopengbin.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add gaopengbin-cesium-mcp-runtime --url https://cesium-mcp-runtime--gaopengbin.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gaopengbin-cesium-mcp-runtime": {
            "url": "https://cesium-mcp-runtime--gaopengbin.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "gaopengbin-cesium-mcp-runtime": {
            "type": "http",
            "url": "https://cesium-mcp-runtime--gaopengbin.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http gaopengbin-cesium-mcp-runtime https://cesium-mcp-runtime--gaopengbin.run.tools
```

## When to use it
- display geographic data on an interactive 3D map
- add and manage multiple layers (GeoJSON, heatmaps, 3D Tiles)
- animate object movement along paths and orbital trajectories
- load 3D models and terrain data onto a globe
- control the camera (fly to, rotate, zoom, persist state)

## Example prompts
- Show European cities as markers on the globe with labels
- Load a GeoJSON file with regional boundaries, color by temperature, and overlay a heatmap
- Move the camera to 55.75,37.62, orbit around the center, and capture a screenshot

## Similar
- [cesium-mcp-dev](https://affpapa.org/en/nevibecode/mcp/cesium-mcp-dev.md) — MCP server · ★ 153 repo stars
- [geospatial-and-cartographic-visualization](https://affpapa.org/en/nevibecode/skills/geospatial-and-cartographic-visualization.md) — skill · 13 installs
- [mapbox-mcp-runtime-patterns](https://affpapa.org/en/nevibecode/skills/mapbox-mcp-runtime-patterns.md) — skill · 1400 installs
- [remotion-maps](https://affpapa.org/en/nevibecode/skills/remotion-maps.md) — skill · 3 installs
- [mapbox-cartography](https://affpapa.org/en/nevibecode/skills/mapbox-cartography.md) — skill · 2200 installs
- [Godot MCP Runtime](https://affpapa.org/en/nevibecode/mcp/godot-mcp-runtime.md) — MCP server · ★ 101 repo stars

## Other versions with the same name
- [cesium-mcp-runtime · gaopengbin](https://affpapa.org/en/nevibecode/mcp/cesium-mcp-runtime.md) — ★ 153 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
