Demo

https://github.com/user-attachments/assets/8a40565a-fcdd-47bf-ae67-bc870611c908

Pakete

Paket	Beschreibung	npm
cesium-mcp-bridge	Browser-SDK — wird in Ihre CesiumJS-App eingebettet, empfängt Befehle über WebSocket
cesium-mcp-runtime	MCP-Server (stdio + HTTP) — 58 Werkzeuge (12 Werkzeugsets) + 2 Ressourcen, dynamische Erkennung
cesium-mcp-dev	IDE-MCP-Server — CesiumJS-API-Helfer für Programmierassistenten

Architektur

flowchart LR
  subgraph clients ["AI Clients"]
    A["Claude / Cursor\nVS Code"]
    D["Dify / n8n\nRemote MCP"]
  end

  subgraph server ["cesium-mcp-runtime\n(Node.js)"]
    R["MCP Server\n58 tools · 12 toolsets"]
  end

  subgraph browser ["Browser"]
    B["cesium-mcp-bridge"]
    C["CesiumJS Viewer"]
  end

  A -- "stdio / MCP" --> R
  D -- "Streamable HTTP" --> R
  R -- "WebSocket\nJSON-RPC" --> B
  B --> C

  style clients fill:#1e293b,stroke:#528bff,color:#e2e8f0
  style server fill:#1e293b,stroke:#155EEF,color:#e2e8f0
  style browser fill:#1e293b,stroke:#12B76A,color:#e2e8f0

Schnellstart

1. Installieren Sie die Bridge in Ihrer CesiumJS-App

npm install cesium-mcp-bridge

import { CesiumBridge } from 'cesium-mcp-bridge';

const bridge = new CesiumBridge(viewer);

2. Starten Sie die MCP-Runtime

# stdio mode (default — for Claude Desktop, VS Code, Cursor)
npx cesium-mcp-runtime

# HTTP mode (for Dify, remote/cloud MCP clients)
npx cesium-mcp-runtime --transport http --port 3000

3. Verbinden Sie Ihren KI-Agenten

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu (z. B. Claude Desktop):

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

Fragen Sie nun Ihre KI: "Fliege zum Eiffelturm und füge eine rote Markierung hinzu"

58 verfügbare Werkzeuge

Die Werkzeuge sind in 12 Werkzeugsets organisiert. Der Standardmodus aktiviert 4 Kern-Werkzeugsets (~31 Werkzeuge). Setzen Sie CESIUM_TOOLSETS=all für alles, oder lassen Sie die KI die Werkzeugsets zur Laufzeit dynamisch entdecken und aktivieren.

i18n: Werkzeugbeschreibungen sind standardmäßig auf Englisch. Setzen Sie CESIUM_LOCALE=zh-CN für Chinesisch.

Werkzeugset	Werkzeuge
view (Standard)	`flyTo`, `setView`, `getView`, `zoomToExtent`, `saveViewpoint`, `loadViewpoint`, `listViewpoints`, `exportScene`
entity (Standard)	`addMarker`, `addLabel`, `addModel`, `addPolygon`, `addPolyline`, `updateEntity`, `removeEntity`, `batchAddEntities`, `queryEntities`, `getEntityProperties`
layer (Standard)	`addGeoJsonLayer`, `listLayers`, `removeLayer`, `clearAll`, `setLayerVisibility`, `updateLayerStyle`, `getLayerSchema`, `setBasemap`
interaction (Standard)	`screenshot`, `highlight`, `measure`
camera	`lookAtTransform`, `startOrbit`, `stopOrbit`, `setCameraOptions`
entity-ext	`addBillboard`, `addBox`, `addCorridor`, `addCylinder`, `addEllipse`, `addRectangle`, `addWall`
animation	`createAnimation`, `controlAnimation`, `removeAnimation`, `listAnimations`, `updateAnimationPath`, `trackEntity`, `controlClock`, `setGlobeLighting`
tiles	`load3dTiles`, `loadTerrain`, `loadImageryService`, `loadCzml`, `loadKml`
trajectory	`playTrajectory`
heatmap	`addHeatmap`
scene	`setSceneOptions`, `setPostProcess`
geolocation	`geocode`

Beziehung zu den offiziellen MCP-Servern von CesiumGS: Die Werkzeugsets camera, entity-ext und animation führen nativ Funktionen von CesiumGS/cesium-mcp-server (Camera Server, Entity Server, Animation Server) in die vereinheitlichte Bridge-Architektur dieses Projekts zusammen. Das bedeutet, Sie erhalten alle offiziellen Funktionen plus zusätzliche Werkzeuge – in einem einzigen MCP-Server, ohne mehrere Prozesse ausführen zu müssen.

Beispiele

Siehe examples/minimal/ für eine vollständige funktionierende Demo.

Entwicklung

git clone https://github.com/gaopengbin/cesium-mcp.git
cd cesium-mcp
npm install
npm run build

Versionsrichtlinie

Versionsformat: {CesiumMajor}.{CesiumMinor}.{MCPPatch}

Segment	Bedeutung	Beispiel
`1.139`	Folgt der CesiumJS-Version — erstellt & getestet mit Cesium `~1.139.0`	`1.139.8` → Cesium 1.139
`.8`	MCP-Patch — unabhängige Iterationen für neue Werkzeuge, Fehlerbehebungen, Dokumentation	`1.139.7` → `1.139.8`

Wenn CesiumJS eine neue Nebenversion veröffentlicht (z. B. 1.140), werden wir entsprechend erhöhen: 1.140.0.

Star-Verlauf

Lizenz

MIT

cesium-mcp