cesium-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CESIUM_TOOLSETS | No | Comma-separated list of toolset groups to enable (e.g. camera,bindbindentity,bindlayer). Use 'all' for all 43 tools. | all |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Cesium MCP Runtime provides tools for controlling a CesiumJS 3D globe via AI. A browser with cesium-mcp-bridge must be connected via WebSocket for command execution. Use view tools (flyTo, setView) to navigate, entity tools to add markers/polygons/models, layer tools to manage GeoJSON/3D Tiles, and animation tools for time-based animations.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| openCesiumMapA | Open an interactive 3D map beside the conversation. Pass the returned sessionId to every map tool. Call once to open the map, then wait until its browser session connects before sending commands. Optionally reopen a known session. |
| connectCesiumMapD | Internal map app transport: connect. |
| exchangeCesiumMapD | Internal map app transport: exchange. |
| disconnectCesiumMapC | Internal map app transport: disconnect. |
| flyToA | Animate the camera to a geographic location. Use for visible navigation requested by the user. Returns { success: boolean, message?: string, error?: string }. |
| setViewA | Set the camera position immediately without animation. Use for deterministic setup or instant view changes. Returns { success: boolean, message?: string, error?: string }. |
| getViewA | Get the current camera position and orientation. Returns { success, data: { longitude, latitude, height, heading, pitch, roll }, message? }. |
| zoomToExtentA | Animate the camera to a west/south/east/north bounding box. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| saveViewpointA | Save the current camera state under a page-local name. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| loadViewpointA | Restore a previously saved page-local camera state. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| listViewpointsA | List camera viewpoints saved in the current page. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| exportSceneA | Export the current view, layer, and entity state as JSON. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| addMarkerA | Add a point marker at geographic coordinates. Returns { success, data: { entityId }, message? }; keep entityId for removeEntity. |
| addLabelC | Add property-based text labels for GeoJSON features. Returns { success, data: { labelCount: integer }, message? }. |
| addModelA | Add a glTF or GLB model at geographic coordinates. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| addPolygonA | Draw a polygon area from geographic coordinate tuples. Returns { success, data: { entityId }, message? }; keep entityId for removeEntity. |
| addPolylineA | Draw a path or route from geographic coordinate tuples. Returns { success, data: { entityId }, message? }; keep entityId for removeEntity. |
| updateEntityB | Update the position, appearance, label, visibility, or polygon extrusion height of an entity, including data-source entities. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| removeEntityA | Remove one entity created by an entity tool. Returns { success, message? } or { success: false, error } when entityId is not found. |
| batchAddEntitiesC | Add multiple supported entities in one page operation. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| queryEntitiesA | Query page entities by name, type, or geographic extent. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| getEntityPropertiesA | Read the properties and graphics metadata for one entity. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| addGeoJsonLayerB | Add a styled GeoJSON Point, LineString, or Polygon layer. Returns { success, data: { id, name, type, visible, color, dataRefId? }, message? }; use id with highlight. |
| addGeoJsonPrimitiveB | Render GeoJSON as Cesium primitives for large browser datasets. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| listLayersA | List all layers currently managed by the page. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| getLayerSchemaA | Inspect fields, entity counts, and metadata for a layer. For vector/3D Tiles, metadata.tileStyle returns the applied style expressions. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| getSelectedTileFeatureA | Read the last clicked managed vector/3D Tiles feature attributes and layerId. Use updateLayerStyle with that layerId to style it. Returns feature=null when nothing is selected; metadata is a snapshot, not a whole-dataset query. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| removeLayerA | Remove a managed layer from the page. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| clearAllA | Clear all layers, entities, animations, and trajectories from the scene. Returns { success, data: { removedLayers, removedEntities }, message? }. |
| setLayerVisibilityA | Show or hide a managed layer. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| updateLayerStyleB | Update vector, imagery, primitive, or 3D Tiles styling for a layer. Returns { success: boolean, data?: unknown, message?: string, error?: string }. |
| setBasemapA | Switch the visible basemap style. Returns { success, data: { basemap }, message? }. |
| screenshotA | Capture the current Cesium map view as a PNG image. Returns { success, data: { dataUrl, width, height }, message? }; dataUrl is a base64 PNG. |
| highlightA | Highlight one feature or every feature in a GeoJSON layer. Returns { success: boolean, message?: string, error?: string }. |
| measureA | Measure distance or area between geographic coordinate tuples. Returns { success, data: { mode, value, unit, segments?, id? }, message? }. |
| storeResourceA | Store GeoJSON, CZML, or JSON once and return a compact resourceId for later tool calls. |
| listResourcesA | List resource metadata for the current browser or MCP session without returning payloads. |
| deleteResourceB | Delete one session-scoped resource by resourceId. |
| list_toolsetsA | List all available tool groups and their enabled status. Call this to discover additional capabilities before asking the user to configure anything. |
| enable_toolsetA | Enable a tool group to make its tools available. Call list_toolsets first to see available groups. |
| listSessionsA | List all connected browser sessions (ID and connection state) for multi-browser routing |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| cesium-quickstart | Quick reference for using Cesium MCP tools |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| camera | 当前相机状态(经纬度、高度、角度) |
| layers | 当前已加载的图层列表(ID、名称、类型、可见性) |
| Cesium map | Interactive CesiumJS map with session routing and selected-object context. |
TDQS
Scored across 41 tools
Most tools target clearly distinct resources or actions, and descriptions distinguish similar operations such as entity vs. layer updates. However, addGeoJsonPrimitive vs. addGeoJsonLayer overlap in purpose, and exposed internal transport tools like connectCesiumMap/exchangeCesiumMap could be confused with openCesiumMap.
The set is predominantly consistent camelCase verb_noun naming (addMarker, updateLayerStyle, removeEntity, flyTo). Minor deviations include snake_case list_toolsets/enable_toolset and a few noun-only or verb-only names like screenshot, highlight, and measure.
At 41 tools, the surface is heavy for a single MCP server even though the Cesium map domain is broad. Several tools are internal transport or toolset-management utilities, which adds surface area beyond the core mapping workflow.
Coverage is broad: sessions, layers, resources, viewpoints, camera control, entity CRUD, styling, measurement, screenshots, basemap, export, and toolset discovery are all present. Minor gaps remain, notably no creation tools for animations/trajectories despite clearAll referencing them, and no import counterpart to exportScene.