# cesium-mcp-runtime

Lets AI assistants control CesiumJS 3D globes through MCP. Adjusts cameras, displays vector layers, and tracks map entities during chats.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 145
- Author: gaopengbin
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gaopengbin/cesium-mcp/tree/HEAD/packages/cesium-mcp-runtime
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/cesium-mcp-runtime

## What it does

This server connects AI assistants with CesiumJS environments. It translates tool calls into WebSocket instructions for the browser bridge. The npm package contains a built-in Viewer at `http://localhost:9100/`. You do not need to install `cesium-mcp-bridge` separately for default local testing.

Communication happens via stdio or streamable HTTP. When running in HTTP mode, all 62 scene manipulation tools activate immediately. The package also embeds an interactive map panel called `openCesiumMap` for native client interfaces.

Telemetry is active on startup. Pass `--no-telemetry` or set `CESIUM_TELEMETRY_DISABLED=1` to silence it. Handling vector tiles requires CesiumJS 1.145. Opening files directly via `file://` URLs fails because the runtime requires a running HTTP server.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add cesium-mcp-runtime -- npx -y cesium-mcp-runtime
```

### Codex

**Platform CLI**
```bash
codex mcp add cesium-mcp-runtime -- npx -y cesium-mcp-runtime
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cesium-mcp-runtime": {
            "command": "npx",
            "args": [
                "-y",
                "cesium-mcp-runtime"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cesium-mcp-runtime": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "cesium-mcp-runtime"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add cesium-mcp-runtime npx -y cesium-mcp-runtime
```

## When to use it
- direct the 3D globe camera to target coordinates
- render MVT vector tiles via `loadVectorTiles`
- style geometric layers using `updateLayerStyle`
- embed an interactive map panel via MCP Apps

## Example prompts
- Launch the Cesium map viewer using `openCesiumMap`.
- Load vector tiles and inspect the properties of the selected feature.
- Fly the camera to coordinates and adjust the layer style colors.

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [tldraw](https://affpapa.org/en/nevibecode/mcp/tldraw.md) — MCP server · ★ 51091
- [Figma-Context-MCP](https://affpapa.org/en/nevibecode/mcp/figma-context-mcp.md) — MCP server · ★ 16062
- [mcp-server-chart](https://affpapa.org/en/nevibecode/mcp/mcp-server-chart.md) — MCP server · ★ 4402
- [Dembrandt](https://affpapa.org/en/nevibecode/mcp/dembrandt.md) — MCP server · ★ 3821
- [RevoGrid DataGrid MCP Pro](https://affpapa.org/en/nevibecode/mcp/revogrid-datagrid-mcp-pro.md) — MCP server · ★ 3450

From the same set: [gaopengbin/cesium-mcp](https://affpapa.org/en/nevibecode/by/gaopengbin/cesium-mcp.md) — 2 cards

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