/ Directorio / Playground / Cesium MCP
● Comunidad gaopengbin 🔑 Requiere tu clave

Cesium MCP

por gaopengbin · gaopengbin/cesium-mcp

Control en lenguaje natural sobre un globo 3D de CesiumJS: vuele la cámara, suelte entidades, alterne capas, cargue mosaicos 3D, anime trayectorias.

cesium-mcp permite que un cliente MCP controle un visor CesiumJS existente. 58 herramientas en 12 conjuntos de herramientas cubren navegación de cámara/vista, entidades (marcadores, etiquetas, modelos, polígonos, polilíneas), capas (GeoJSON, mapas base), interacción (capturas de pantalla, resaltado, medición) y funciones avanzadas (mosaicos 3D, terreno, animación, trayectorias, mapas de calor, geolocalización). Las herramientas Core 31 se activan de forma predeterminada; establezca CESIUM_TOOLSETS=all para el conjunto completo. Combínelo con cualquier aplicación que incorpore CesiumJS para obtener visualización geoespacial impulsada por IA.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

cesium-mcp.replay ▶ listo
0/0

Instalar

Elige tu cliente

~/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"
      }
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

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

Continue usa un array de objetos de servidor en lugar de un mapa.

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Cesium MCP

Realice una sesión informativa sobre la ubicación en un globo terráqueo en vivo

👤 Equipos de operaciones, logística y planificación. ⏱ ~15 min intermediate

Cuándo usarlo: Quiere una sesión informativa en vivo en 3D en lugar de diapositivas estáticas.

Requisitos previos
  • Una aplicación de visualización CesiumJS en ejecución — Incorpore Cesium en su aplicación; exponer el conector
  • Token de acceso de iones de cesio (si se utilizan activos de iones) — https://ion.cesium.com/tokens
Flujo
  1. Vuela al sitio
    Vuela a la Torre Eiffel y coloca un marcador rojo con la etiqueta "Sitio A".✓ Copiado
    → La cámara anima; el marcador aparece con la etiqueta
  2. datos superpuestos
    Cargue este GeoJSON de límites de vecindad como una capa translúcida.✓ Copiado
    → Capa visible e interactiva.
  3. Captura
    Tome una captura de pantalla que pueda pegar en la diapositiva.✓ Copiado
    → PNG devuelto

Resultado: Una vista informativa en vivo y vinculable en lugar de una imagen congelada.

Errores comunes
  • Cargando un GeoJSON enorme sin simplificación — Simplifique a recuentos de vértices razonables; El cesio puede ahogarse en polígonos de millones de vértices
Combinar con: filesystem

Animar la trayectoria de una flota a lo largo del tiempo.

👤 Equipos de operaciones y movilidad ⏱ ~25 min intermediate

Cuándo usarlo: Tiene posiciones con marca de tiempo y desea una reproducción en el mundo.

Requisitos previos
  • Datos de posición codificados por tiempo — CSV o GeoJSON con marcas de tiempo
Flujo
  1. Cargar entidades con tiempo
    Agregue 3 entidades de vehículos con sus pistas SampledPositionProperty desde flota.csv.✓ Copiado
    → Las entidades rinden; la línea de tiempo muestra el lapso
  2. Jugar
    Animar a 10x, la cámara sigue al vehículo A.✓ Copiado
    → Reproducción fluida; cámara bloqueada al sujeto

Resultado: Reproducción interactiva de flotas sin escribir código Cesium.

Cargue un conjunto de datos de 3D Tiles e inspeccione un solo edificio

👤 Equipos de urbanismo, AEC, BIM ⏱ ~20 min advanced

Cuándo usarlo: Tienes un conjunto de mosaicos 3D Tiles y deseas consultar una función.

Flujo
  1. Cargar el conjunto de mosaicos
    Cargue mosaicos 3D en <URL>, oriente el terreno, establezca el error de espacio máximo en pantalla 16.✓ Copiado
    → Tileset renderiza sin lucha en profundidad
  2. Resaltar + medir
    Resalte el edificio en la entidad elegida; medir su altura.✓ Copiado
    → Edificio resaltado; altura reportada

Resultado: Inspección interactiva rápida para revisión de las partes interesadas.

Errores comunes
  • Recorte de cámara a través del terreno — Habilitar pruebas de profundidad contra el terreno; sintonizar clip cercano/lejano

Superponer un mapa de calor de datos de puntos

👤 Analistas visualizando la densidad ⏱ ~15 min intermediate

Cuándo usarlo: Necesita un mapa de calor en un mapa sin una herramienta de trazado externa.

Flujo
  1. Puntos de ingesta
    Importar puntos.csv (longitud, latitud, peso).✓ Copiado
    → Puntos cargados en un conjunto de herramientas de mapa de calor
  2. Sintonizar apariencia
    Radio del mapa de calor 25 px, viridis degradado.✓ Copiado
    → Superposición con estilo visible

Resultado: Un mapa de calor defendible integrado en su globo.

Combinar con: mcp-echarts

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

cesium-mcp + filesystem

Cargue conjuntos de datos locales (GeoJSON, CSV) y renderice en el mundo

Abra ./data/points.csv, importe como un mapa de calor en el mundo.✓ Copiado
cesium-mcp + mcp-echarts

Combine el globo terráqueo 3D con gráficos estadísticos clásicos

Mapa de densidad de cesio + histograma echarts en el lateral: filtros sincronizados.✓ Copiado
cesium-mcp + fetch

Extraiga transmisiones en vivo (AIS, ADS-B) y anime

Obtenga posiciones de embarcaciones en vivo y actualice entidades cada 30 segundos.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
camera.flyTo / lookAt / saveView / loadView coords / heading / pitch / roll Navegación de la cámara 0
entities.add / update / remove geometry + styling Marcadores, etiquetas, modelos, polígonos, polilíneas. 0
layers.add (GeoJSON / imagery) / toggle source + style Alternar o agregar capas geoespaciales bandwidth for remote sources
tiles3d.load / query tileset URL Representación de mosaicos 3D y selección de funciones 0
terrain.set terrain provider Intercambiar proveedores de terreno 0
animation.play / trajectory.load time interval / track Reproducción basada en tiempo 0
interaction.screenshot / highlight / measure area or picked entity Captura, selecciona y mide 0
heatmap.add points + radius + gradient Visualización de densidad 0
geolocation.goto name or coords Navegación por lugar con nombre 0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Ninguno para el servidor en sí; Los tokens de Cesium Ion tienen su propia cuota si usas activos de Ion
Tokens por llamada
Pequeñas operaciones; Mosaicos 3D/bytes de imágenes que no están en el recuento de tokens
Monetario
Gratis: el cesio es de código abierto
Consejo
Quédese con las 31 herramientas principales predeterminadas a menos que necesite específicamente el conjunto extendido; superficie más simple = menos giros equivocados.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Token de iones de cesio en env var si se usa.
Salida de datos: Recupera los proveedores de imágenes/terreno que usted configure (Ion, MapBox, servidores de mosaicos personalizados).

Resolución de problemas

Errores comunes y soluciones

La cámara salta al espacio en lugar del objetivo.

Verifique el orden de latitud/lon (Cesium usa lon, lat) y los valores de altitud.

Verificar: Log args passed to camera.flyTo
GeoJSON parece plano

El muestreo del terreno está desactivado; habilite abrazaderaToGround en las opciones de capa.

Verificar: Inspect the layer's styling options
Conjunto de mosaicos negro / faltante

CORS bloquea muchos conjuntos de mosaicos; host o proxy con encabezados adecuados.

Verificar: DevTools Network panel for the tileset URL

Alternativas

Cesium MCP vs otros

AlternativaCuándo usarlaContrapartida
google-mapsLos mapas 2D y la API de Places son suficientesSin globo 3D ni mosaicos 3D
google-mapYa estás en Google Maps infraMenos rica en 3D que el cesio
mcp-echartsTus datos son estadísticos, no geoespacialesSin contexto de mapa

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills