/ Annuaire / Playground / Cesium MCP
● Communauté gaopengbin 🔑 Nécessite votre clé

Cesium MCP

par gaopengbin · gaopengbin/cesium-mcp

Contrôle en langage naturel sur un globe 3D CesiumJS : pilotez la caméra, déposez des entités, basculez entre les calques, chargez des tuiles 3D, animez des trajectoires.

cesium-mcp permet à un client MCP de piloter un visualiseur CesiumJS existant. 58 outils répartis en 12 ensembles d'outils couvrent la navigation caméra/vue, les entités (marqueurs, étiquettes, modèles, polygones, polylignes), les couches (GeoJSON, fonds de carte), l'interaction (captures d'écran, surbrillance, mesure) et les fonctionnalités avancées (tuiles 3D, terrain, animation, trajectoires, cartes thermiques, géolocalisation). Les outils Core 31 sont activés par défaut ; définissez CESIUM_TOOLSETS=all pour la suite complète. Associez-le à n’importe quelle application intégrant CesiumJS pour obtenir une visualisation géospatiale basée sur l’IA.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

cesium-mcp.replay ▶ prêt
0/0

Installer

Choisissez votre 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"
      }
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Cesium MCP

Effectuez un briefing de localisation sur un globe en direct

👤 Équipes opérationnelles, logistiques et de planification ⏱ ~15 min intermediate

Quand l'utiliser : Vous souhaitez un briefing 3D en direct au lieu de diapositives statiques.

Prérequis
  • Une application de visualisation CesiumJS en cours d'exécution — Intégrez le césium dans votre application ; exposer le connecteur
  • Jeton d'accès Cesium Ion (si vous utilisez des actifs Ion) — https://ion.cesium.com/tokens
Déroulement
  1. Volez vers le site
    Envolez-vous vers la Tour Eiffel et déposez un marqueur rouge avec l'étiquette « Site A ».✓ Copié
    → La caméra s'anime ; le marqueur apparaît avec l'étiquette
  2. Données superposées
    Chargez ce GeoJSON des limites de quartier sous forme de couche translucide.✓ Copié
    → Couche visible et interactive
  3. Capturer
    Prenez une capture d'écran que je peux coller dans la diapositive.✓ Copié
    → PNG retourné

Résultat : Une vue d'information en direct et connectable au lieu d'une image figée.

Pièges
  • Charger un énorme GeoJSON sans simplification — Simplifier pour obtenir un nombre de sommets raisonnable ; Le césium peut s'étouffer avec des polygones d'un million de sommets
Combiner avec : filesystem

Animer la trajectoire d'une flotte dans le temps

👤 Equipes opérations et mobilité ⏱ ~25 min intermediate

Quand l'utiliser : Vous avez des positions horodatées et souhaitez une lecture sur le globe.

Prérequis
  • Données de position codées dans le temps — CSV ou GeoJSON avec horodatages
Déroulement
  1. Charger les entités avec le temps
    Ajoutez 3 entités de véhicules avec leurs pistes SampledPositionProperty à partir de Fleet.csv.✓ Copié
    → Les entités s'affichent ; la chronologie montre la durée
  2. Jouer
    Animée à 10x, la caméra suit le véhicule A.✓ Copié
    → Lecture fluide ; appareil photo verrouillé sur le sujet

Résultat : Lecture interactive de la flotte sans écrire de code Césium.

Chargez un jeu de données de tuiles 3D et inspectez un seul bâtiment

👤 Equipes urbanisme, AEC, BIM ⏱ ~20 min advanced

Quand l'utiliser : Vous disposez d'un jeu de tuiles 3D et souhaitez interroger une entité.

Déroulement
  1. Charger le jeu de tuiles
    Chargez les tuiles 3D sur <URL>, orientez le terrain, définissez l'erreur d'espace d'écran maximum 16.✓ Copié
    → Rendus de jeux de tuiles sans lutte contre la profondeur
  2. Surligner + mesurer
    Mettez en surbrillance le bâtiment de l'entité sélectionnée ; mesurer sa hauteur.✓ Copié
    → Bâtiment mis en valeur ; hauteur signalée

Résultat : Inspection interactive rapide pour l’examen des parties prenantes.

Pièges
  • Découpage de caméra à travers le terrain — Activer les tests de profondeur par rapport au terrain ; régler le clip proche/loin

Superposer une carte thermique de données de points

👤 Les analystes visualisent la densité ⏱ ~15 min intermediate

Quand l'utiliser : Vous avez besoin d'une carte thermique sur une carte sans outil de traçage externe.

Déroulement
  1. Ingérer des points
    Importez points.csv (lon, lat, poids).✓ Copié
    → Points chargés dans un ensemble d'outils de carte thermique
  2. Ajuster l'apparence
    Rayon de la carte thermique 25px, dégradé viridis.✓ Copié
    → Superposition stylisée visible

Résultat : Une carte thermique défendable intégrée à votre globe.

Combiner avec : mcp-echarts

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

cesium-mcp + filesystem

Chargez des ensembles de données locaux (GeoJSON, CSV) et effectuez le rendu sur le globe

Ouvrez ./data/points.csv, importez sous forme de carte thermique sur le globe.✓ Copié
cesium-mcp + mcp-echarts

Associez le globe 3D à des graphiques statistiques classiques

Carte de densité du césium + histogramme echarts sur le côté — filtres synchronisés.✓ Copié
cesium-mcp + fetch

Extrayez des flux en direct (AIS, ADS-B) et animez

Récupérez les positions des navires en direct et mettez à jour les entités toutes les 30 secondes.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
camera.flyTo / lookAt / saveView / loadView coords / heading / pitch / roll Navigation par caméra 0
entities.add / update / remove geometry + styling Marqueurs, étiquettes, modèles, polygones, polylignes 0
layers.add (GeoJSON / imagery) / toggle source + style Basculer ou ajouter des couches géospatiales bandwidth for remote sources
tiles3d.load / query tileset URL Rendu de tuiles 3D et sélection de fonctionnalités 0
terrain.set terrain provider Changer de fournisseur de terrain 0
animation.play / trajectory.load time interval / track Lecture basée sur le temps 0
interaction.screenshot / highlight / measure area or picked entity Capturer, sélectionner et mesurer 0
heatmap.add points + radius + gradient Visualisation de la densité 0
geolocation.goto name or coords Navigation par lieu nommé 0

Coût et limites

Coût d'exécution

Quota d'API
Aucun pour le serveur lui-même ; Les jetons Cesium Ion ont leur propre quota si vous utilisez des actifs Ion
Tokens par appel
Petites opérations ; Tuiles 3D/octets d'images ne figurant pas dans le nombre de jetons
Monétaire
Gratuit — Le césium est open source
Astuce
Restez fidèle aux 31 outils de base par défaut, sauf si vous avez spécifiquement besoin de l'ensemble étendu ; surface plus simple = moins de mauvais virages.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Jeton Cesium Ion dans la variable d'environnement s'il est utilisé.
Sortie de données : Récupère les fournisseurs d'images/de terrain que vous configurez (Ion, MapBox, serveurs de tuiles personnalisés).

Dépannage

Erreurs courantes et correctifs

La caméra saute dans l'espace au lieu de la cible

Vérifiez l'ordre lat/lon (le césium utilise lon, lat) et les valeurs d'altitude.

Vérifier : Log args passed to camera.flyTo
GeoJSON semble plat

L'échantillonnage du terrain est désactivé ; activez clampToGround dans les options de calque.

Vérifier : Inspect the layer's styling options
Tileset noir / manquant

CORS bloque de nombreux ensembles de tuiles ; hôte ou proxy avec les en-têtes appropriés.

Vérifier : DevTools Network panel for the tileset URL

Alternatives

Cesium MCP vs autres

AlternativeQuand l'utiliserCompromis
google-mapsLes cartes 2D et l'API Places suffisentPas de globe 3D ni de tuiles 3D
google-mapVous êtes déjà sur Google Maps infraMoins riche en 3D que le césium
mcp-echartsVos données sont statistiques et non géospatialesAucun contexte de carte

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills