cesium-mcp

Demo

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

Paquetes

Arquitectura

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

Inicio rápido

1. Instala el bridge en tu aplicación CesiumJS

npm install cesium-mcp-bridge

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

const bridge = new CesiumBridge(viewer);

2. Inicia el runtime de MCP

# 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. Conecta tu agente de IA

Añádelo a la configuración de tu cliente MCP (ej. Claude Desktop):

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

Ahora pídele a tu IA: "Vuela a la Torre Eiffel y añade un marcador rojo"

58 herramientas disponibles

Las herramientas están organizadas en 12 conjuntos. El modo predeterminado habilita 4 conjuntos principales (~31 herramientas). Configura CESIUM_TOOLSETS=all para obtener todo, o deja que la IA descubra y active los conjuntos de herramientas dinámicamente en tiempo de ejecución.

i18n: Las descripciones de las herramientas están en inglés por defecto. Configura CESIUM_LOCALE=zh-CN para chino.

Relación con los servidores MCP oficiales de CesiumGS: Los conjuntos de herramientas camera, entity-ext y animation fusionan de forma nativa las capacidades de CesiumGS/cesium-mcp-server (Servidor de cámara, Servidor de entidades, Servidor de animación) en la arquitectura de bridge unificada de este proyecto. Esto significa que obtienes toda la funcionalidad oficial más herramientas adicionales, en un solo servidor MCP, sin necesidad de ejecutar múltiples procesos.

Ejemplos

Consulta examples/minimal/ para ver una demo funcional completa.

Desarrollo

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

Política de versiones

Formato de versión: {CesiumMajor}.{CesiumMinor}.{MCPPatch}

Cuando CesiumJS lance una nueva versión menor (ej. 1.140), actualizaremos en consecuencia: 1.140.0.

Proyectos relacionados

• mapbox-mcp — Control por IA para Mapbox GL JS

• openlayers-mcp — Control por IA para OpenLayers

Historial de estrellas

Licencia

MIT