Cesium Mcp Runtime

Name: Cesium Mcp Runtime
Author: gaopengbin

@gaopengbin

关于 Cesium Mcp Runtime

MCP server that enables AI agents to control CesiumJS 3D globe with natural language. Supports camera flight, entity management, imagery layers, terrain, GeoJSON, trajectory playback, and interactive picking. Works with Claude Desktop, VS Code Copilot, Cursor and any MCP-compatib

#cesiumjs #gis #3d #visualization #geospatial #map #globe #webgl

基本信息

分类

开发工具

传输方式

stdio

发布者

gaopengbin

提交者

gaopengbin

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "cesium-mcp-runtime": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ]
    }
  }
}

工具

飞行到指定经纬度位置（带动画过渡）

添加 GeoJSON 图层到地图（支持 Point/Line/Polygon，可配置颜色/分级/分类渲染）

为 GeoJSON 要素添加文本标注（显示属性值）

添加热力图图层（基于 GeoJSON 点数据生成热力可视化）

从地图上移除指定图层（按图层ID）

切换底图风格（暗色/卫星影像/标准）

截取当前地图视图（返回 base64 PNG）

高亮指定图层的要素

瞬间切换到指定经纬度视角（无动画）

获取当前相机视角信息（经纬度、高度、角度）

缩放到指定地理范围

在指定经纬度添加标注点，返回 layerId 供后续操作

设置图层可见性

获取当前所有图层列表（含 ID、名称、类型、可见性）

修改已有图层的样式（颜色、透明度、标注样式等）

播放移动轨迹动画

加载 3D Tiles 数据集（如建筑白膜、城市模型）

加载或切换地形（平坦/ArcGIS/CesiumIon/自定义 URL）

加载影像服务图层（WMS/WMTS/XYZ/ArcGIS MapServer）

概览

What is Cesium Mcp Runtime?

Cesium Mcp Runtime is a Node.js server that bridges AI agents (via the Model Context Protocol) to a CesiumJS 3D globe viewer. It provides 19 MCP tools and 2 resources that let you control camera, entities, layers, terrain, and interactions using natural language. It is designed for developers building AI-powered geospatial applications with CesiumJS.

How to use Cesium Mcp Runtime?

Install cesium-mcp-bridge in your CesiumJS application, register the viewer with CesiumMCPBridge.register(viewer), then configure your MCP client to run npx cesium-mcp-runtime as the server command.

Key features of Cesium Mcp Runtime

19 MCP tools for full CesiumJS control via natural language
Camera: flyTo, setView, getView, zoomToExtent
Entities: addMarker, addLabel, highlight, removeLayer
Layers: loadImageryService, load3dTiles, addGeoJsonLayer, addHeatmap
Terrain: loadTerrain, setBasemap
Interaction: screenshot, playTrajectory
2 resources: scene state and entity list
Architecturally bridges AI ↔ MCP stdio ↔ Node.js ↔ WebSocket ↔ Browser ↔ CesiumJS Viewer

Use cases of Cesium Mcp Runtime

AI agent controlling a 3D globe by voice or chat commands
Automatically adding markers, labels, and GeoJSON layers to a CesiumJS scene
Flying the camera to specific coordinates or extents on demand
Taking screenshots or replaying trajectories through AI requests
Loading 3D Tiles, imagery services, and terrain without manual code

FAQ from Cesium Mcp Runtime

What MCP tools does Cesium Mcp Runtime provide?

It provides 19 tools covering camera control, entity management, layer loading, terrain/basemap switching, and interaction (screenshot, playTrajectory).

How does Cesium Mcp Runtime connect to CesiumJS?

The server communicates via WebSocket to a browser-side bridge (cesium-mcp-bridge) that must be registered with the CesiumJS viewer.

What are the installation steps?

Install cesium-mcp-bridge in your CesiumJS app, call CesiumMCPBridge.register(viewer), then configure your MCP client to run npx cesium-mcp-runtime.