/ Verzeichnis / Playground / Cesium MCP
● Community gaopengbin 🔑 Eigener Schlüssel nötig

Cesium MCP

von gaopengbin · gaopengbin/cesium-mcp

Steuerung in natürlicher Sprache über einen CesiumJS-3D-Globus: Steuern Sie die Kamera, legen Sie Elemente ab, schalten Sie Ebenen um, laden Sie 3D-Kacheln und animieren Sie Flugbahnen.

Mit cesium-mcp kann ein MCP-Client einen vorhandenen CesiumJS-Viewer steuern. 58 Tools in 12 Toolsets decken Kamera-/Ansichtsnavigation, Entitäten (Markierungen, Beschriftungen, Modelle, Polygone, Polylinien), Ebenen (GeoJSON, Grundkarten), Interaktion (Screenshots, Hervorhebung, Messung) und erweiterte Funktionen (3D-Kacheln, Gelände, Animation, Flugbahnen, Heatmaps, Geolokalisierung) ab. Core 31-Tools werden standardmäßig aktiviert. Setzen Sie „CESIUM_TOOLSETS=all“ für die gesamte Suite. Kombinieren Sie es mit einer beliebigen App, die CesiumJS einbettet, um eine KI-gesteuerte Geodatenvisualisierung zu erhalten.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

cesium-mcp.replay ▶ bereit
0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ],
      "env": {
        "CESIUM_TOOLSETS": "all"
      }
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ],
      "env": {
        "CESIUM_TOOLSETS": "all"
      }
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ],
      "env": {
        "CESIUM_TOOLSETS": "all"
      }
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ],
      "env": {
        "CESIUM_TOOLSETS": "all"
      }
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "cesium-mcp",
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "cesium-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "cesium-mcp-runtime"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add cesium-mcp -- npx -y cesium-mcp-runtime

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Cesium MCP

Fliegen Sie eine Standortbesprechung auf einem lebenden Globus

👤 Betriebs-, Logistik- und Planungsteams ⏱ ~15 min intermediate

Wann einsetzen: Sie möchten ein Live-3D-Briefing statt statischer Folien.

Voraussetzungen
  • Eine laufende CesiumJS-Viewer-App — Betten Sie Cäsium in Ihre App ein; den Stecker freilegen
  • Cäsium-Ionen-Zugriffstoken (bei Verwendung von Ion-Assets) — https://ion.cesium.com/tokens
Ablauf
  1. Fliegen Sie zur Website
    Fliegen Sie zum Eiffelturm und werfen Sie einen roten Marker mit der Aufschrift „Standort A“ ab.✓ Kopiert
    → Kamera animiert; Markierung erscheint mit Beschriftung
  2. Daten überlagern
    Laden Sie dieses GeoJSON der Nachbarschaftsgrenzen als durchscheinende Ebene.✓ Kopiert
    → Ebene sichtbar und interaktiv
  3. Erfassen
    Machen Sie einen Screenshot, den ich in die Folie einfügen kann.✓ Kopiert
    → PNG ist zurückgekehrt

Ergebnis: Eine verlinkbare Live-Briefing-Ansicht anstelle eines eingefrorenen Bildes.

Fallstricke
  • Laden eines riesigen GeoJSON ohne Vereinfachung — Auf vernünftige Scheitelpunktzahlen vereinfachen; Cäsium kann an Polygonen mit Millionen Scheitelpunkten ersticken
Kombinieren mit: filesystem

Animieren Sie die Flugbahn einer Flotte im Zeitverlauf

👤 Betriebs- und Mobilitätsteams ⏱ ~25 min intermediate

Wann einsetzen: Sie haben zeitgestempelte Positionen und möchten eine Wiedergabe auf dem Globus.

Voraussetzungen
  • Zeitcodierte Positionsdaten — CSV oder GeoJSON mit Zeitstempeln
Ablauf
  1. Entitäten mit der Zeit laden
    Fügen Sie 3 Fahrzeugentitäten mit ihren SampledPositionProperty-Tracks aus Fleet.csv hinzu.✓ Kopiert
    → Entitäten rendern; Die Zeitleiste zeigt die Spanne
  2. Spielen
    Mit 10-facher Vergrößerung animieren, die Kamera folgt Fahrzeug A.✓ Kopiert
    → Reibungslose Wiedergabe; Kamera auf Motiv fixiert

Ergebnis: Interaktive Flottenwiedergabe, ohne Cäsium-Code zu schreiben.

Laden Sie einen 3D-Kacheldatensatz und prüfen Sie ein einzelnes Gebäude

👤 Stadtplanung, AEC, BIM-Teams ⏱ ~20 min advanced

Wann einsetzen: Sie haben ein 3D-Kachel-Kachelset und möchten eine Funktion abfragen.

Ablauf
  1. Laden Sie das Kachelset
    Laden Sie 3D-Kacheln unter <URL>, richten Sie das Gelände aus und legen Sie den maximalen Bildschirmbereich fest. Fehler 16.✓ Kopiert
    → Tileset-Renderings ohne Tiefenkampf
  2. Markieren + messen
    Markieren Sie das Gebäude am ausgewählten Objekt. Messen Sie seine Höhe.✓ Kopiert
    → Gebäude hervorgehoben; Höhe angegeben

Ergebnis: Schnelle interaktive Inspektion zur Überprüfung durch Stakeholder.

Fallstricke
  • Kameraausschnitt durch Gelände — Aktivieren Sie Tiefentests im Gelände. Nah-/Fernclip abstimmen

Überlagern Sie eine Heatmap mit Punktdaten

👤 Analysten visualisieren Dichte ⏱ ~15 min intermediate

Wann einsetzen: Sie benötigen eine Heatmap auf einer Karte ohne externes Plottool.

Ablauf
  1. Punkte aufnehmen
    Importieren Sie „points.csv“ (Länge, Breite, Gewicht).✓ Kopiert
    → In ein Heatmap-Toolset geladene Punkte
  2. Aussehen optimieren
    Heatmap-Radius 25 Pixel, Farbverlauf.✓ Kopiert
    → Gestyltes Overlay sichtbar

Ergebnis: Eine vertretbare Heatmap, die in Ihren Globus integriert ist.

Kombinieren mit: mcp-echarts

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

cesium-mcp + filesystem

Laden Sie lokale Datensätze (GeoJSON, CSV) und rendern Sie sie auf dem Globus

Öffnen Sie ./data/points.csv und importieren Sie es als Heatmap auf dem Globus.✓ Kopiert
cesium-mcp + mcp-echarts

Kombinieren Sie den 3D-Globus mit klassischen Statistikdiagrammen

Cäsium-Dichtekarte + Echarts-Histogramm an der Seite – synchronisierte Filter.✓ Kopiert
cesium-mcp + fetch

Live-Feeds abrufen (AIS, ADS-B) und animieren

Rufen Sie alle 30 Sekunden aktuelle Schiffspositionen ab und aktualisieren Sie die Entitäten.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
camera.flyTo / lookAt / saveView / loadView coords / heading / pitch / roll Kameranavigation 0
entities.add / update / remove geometry + styling Markierungen, Beschriftungen, Modelle, Polygone, Polylinien 0
layers.add (GeoJSON / imagery) / toggle source + style Geodatenebenen umschalten oder hinzufügen bandwidth for remote sources
tiles3d.load / query tileset URL 3D-Kachel-Rendering und Feature-Auswahl 0
terrain.set terrain provider Geländeanbieter tauschen 0
animation.play / trajectory.load time interval / track Zeitbasierte Wiedergabe 0
interaction.screenshot / highlight / measure area or picked entity Erfassen, auswählen und messen 0
heatmap.add points + radius + gradient Dichtevisualisierung 0
geolocation.goto name or coords Navigation nach benannten Orten 0

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
Keine für den Server selbst; Für Cäsium-Ionen-Tokens gilt ein eigenes Kontingent, wenn Sie Ionen-Assets verwenden
Tokens pro Aufruf
Kleine Operationen; 3D-Kacheln/Bildbytes nicht in der Token-Anzahl
Kosten in €
Kostenlos – Cäsium ist Open Source
Tipp
Bleiben Sie bei den standardmäßigen 31 Kernwerkzeugen, es sei denn, Sie benötigen ausdrücklich den erweiterten Satz; einfachere Oberfläche = weniger falsche Kurven.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: Cäsiumionen-Token in der Umgebungsvariable, falls verwendet.
Datenabfluss: Ruft Bild-/Geländeanbieter ab, die Sie konfigurieren (Ion, MapBox, benutzerdefinierte Kachelserver).

Fehlerbehebung

Häufige Fehler und Lösungen

Die Kamera springt in den Weltraum statt zum Ziel

Überprüfen Sie die Breiten-/Längenreihenfolge (Cäsium verwendet Längen- und Breitengrade) und die Höhenwerte.

Prüfen: Log args passed to camera.flyTo
GeoJSON sieht flach aus

Die Geländeprobenahme ist deaktiviert. Aktivieren Sie „clampToGround“ in den Ebenenoptionen.

Prüfen: Inspect the layer's styling options
Tileset schwarz / fehlt

CORS blockiert viele Tilesets; Host oder Proxy mit den richtigen Headern.

Prüfen: DevTools Network panel for the tileset URL

Alternativen

Cesium MCP vs. andere

AlternativeWann stattdessenKompromiss
google-maps2D-Karten und Places API sind ausreichendKein 3D-Globus oder 3D-Kacheln
google-mapSie befinden sich bereits auf Google Maps InfraWeniger 3D-reich als Cäsium
mcp-echartsIhre Daten sind statistisch und nicht geografischKein Kartenkontext

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen