# cesium-mcp-runtime

Cesium MCP Runtime Server — AI Agent 通过 MCP 协议操控浏览器 Cesium

- **Type:** MCP server
- **Trust:** 60/100 (B), scored on the package rubric
- **Verification:** community-indexed — nobody has claimed this listing
- **Version:** 1.145.1
- **Author:** io.github.gaopengbin
- **License:** MIT
- **npm:** cesium-mcp-runtime
- **Source:** https://github.com/gaopengbin/cesium-mcp
- **Compatible clients:** claude-code, cursor, copilot, gemini (basis: transport)

## Trust

60/100 (B), scored on the package rubric
- Publisher verified: no
- Install scripts: nothing suspicious found
- Prompt-injection scan: not run
- Obfuscation scan: not run
- Evidence age: 0 days

## Security scan

- **Status:** clean
- **Scanned:** 2026-09-17T01:21:56.706Z
- **Version scanned:** 1.145.1
- **CVEs:** none found by OSV at scan time

## Tools

40 declared. Statically extracted from the shipped source — a floor on the surface, not a census.
- `flyTo` — 飞行到指定经纬度位置（带动画过渡）
- `addGeoJsonLayer` — 添加 GeoJSON 图层到地图（支持 Point/Line/Polygon，可配置颜色/分级/分类渲染）。data 和 url 二选一
- `addGeoJsonPrimitive` — 高性能加载大规模 GeoJSON 数据（10万+ 要素）。绕过 Entity 系统，直接使用 Primitive 渲染，适合海量数据可视化。data 和 url 二选一
- `addLabel` — 为 GeoJSON 要素添加文本标注（显示属性值）
- `addHeatmap` — 添加热力图图层（基于 GeoJSON 点数据生成热力可视化，贴图到地面）
- `removeLayer` — 从地图上移除指定图层（按图层ID）
- `clearAll` — 清除地图上的所有图层、实体、动画和轨迹（一键重置场景）
- `setBasemap` — 切换底图风格
- `screenshot` — 截取当前地图视图（返回 base64 PNG）
- `highlight` — 高亮指定图层的要素（支持清除恢复原始样式）
- `measure` — 测量距离或面积（基于坐标计算，可在地图上显示）
- `setView` — 瞬间切换到指定经纬度视角（无动画）
- `getView` — 获取当前相机视角信息（经纬度、高度、角度）
- `zoomToExtent` — 缩放到指定地理范围
- `addMarker` — 在指定经纬度添加标注点，返回 layerId 供后续操作
- `addPolyline` — 在地图上添加折线（路径、线段），返回 entityId
- `addPolygon` — 在地图上添加多边形区域（面积、边界），返回 entityId
- `addModel` — 在指定经纬度放置 3D 模型（glTF/GLB），返回 entityId
- `updateEntity` — 更新已有实体的属性（位置、颜色、标签、缩放、可见性）
- `removeEntity` — 移除单个实体（通过 entityId）
- `batchAddEntities` — 批量添加多个实体（一次调用创建多个 marker/polyline/polygon/model 等），返回所有 entityId
- `queryEntities` — 查询已有实体 — 按名称、类型、空间范围过滤，返回 entityId/name/type/position 列表
- `getEntityProperties` — 获取指定实体的详细属性 — 包括类型、位置、自定义属性和图形属性
- `saveViewpoint` — 保存当前视角为书签（名称 → 视角状态），可通过 loadViewpoint 恢复
- `loadViewpoint` — 恢复已保存的视角书签（带飞行动画），返回保存的视角状态
- `listViewpoints` — 列出所有已保存的视角书签
- `exportScene` — 导出当前场景快照 — 包含视角、图层列表、实体列表和时间戳
- `setLayerVisibility` — 设置图层可见性
- `listLayers` — 获取当前所有图层列表（含 ID、名称、类型、可见性）
- `getLayerSchema` — 获取图层的属性字段结构 — 返回字段名、类型、示例值，适用于 GeoJSON/CZML/KML/3D Tiles 图层
- `updateLayerStyle` — 修改已有图层的样式（颜色、透明度、标注样式、3D Tiles 样式等）
- `playTrajectory` — 播放移动轨迹动画
- `load3dTiles` — 加载 3D Tiles 数据集（支持 URL 或 Cesium Ion 资产 ID）
- `load3dGaussianSplat` — 加载 3D 高斯泼溅（Gaussian Splat）数据集
- `loadTerrain` — 加载或切换地形（平坦/ArcGIS/CesiumIon/自定义 URL）
- `loadImageryService` — 加载影像服务图层（WMS/WMTS/XYZ/ArcGIS MapServer/Cesium Ion）
- `loadCzml` — 加载 CZML 时序数据源（CesiumJS 原生格式，支持时变位置/样式/动画）。data 和 url 二选一
- `loadKml` — 加载 KML/KMZ 数据源（Google Earth 格式）。url 和 data 二选一
- `setEdgeDisplayMode` — 设置 3D Tiles 边缘显示模式（仅表面 / 表面+边缘 / 仅边缘线框）
- `lookAtTransform` — Look at a specific position from a given heading/pitch/range (orbit-style camera)

## Install

**Verdict: review** — Installable, but 1 thing to check first: No publisher has proved control of this listing; it is indexed, not vouched for.
**Cautions** (coverage gaps and advisories — never blocking)
- No publisher has proved control of this listing; it is indexed, not vouched for.
**Config** (claude-code):
```json
"{\n  \"mcpServers\": {\n    \"cesium-mcp-runtime\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"cesium-mcp-runtime\"\n      ]\n    }\n  }\n}"
```

## Blast radius

Contained to moderate — no credential declaration found, from the publisher, the upstream registry, or the README. Known so far: runs on your machine; read-only tool surface.
- Floor 12, ceiling 30 (tier: unknown)
- `unknown` means the floor and ceiling land in different bands — not measured enough to name one. It does not mean low.
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/cesium-mcp-runtime
- Install plan: https://forgeregistry.com/api/v1/packages/cesium-mcp-runtime/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/cesium-mcp-runtime
- HTML page: https://forgeregistry.com/registry/cesium-mcp-runtime
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.