Cesium MCP MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

58 ferramentas em 12 conjuntos de ferramentas
Controle de câmera e ponto de vista (fly-to, lookAt, visualizações salvas)
Entidade CRUD — marcadores, rótulos, modelos 3D, polígonos, polilinhas
Camadas — GeoJSON, mapas base de imagens, visibilidade
Avançado – blocos 3D, terreno, animação, trajetórias, mapas de calor, geolocalização
Interação – capturas de tela, destaque, medição

Demo ao vivo

Como fica na prática

cesium-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu 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"
      }
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Cesium MCP

Faça um briefing de localização em um globo ao vivo

👤 Equipes de operações, logística e planejamento ⏱ ~15 min intermediate

Quando usar: Você deseja um briefing 3D ao vivo em vez de slides estáticos.

Pré-requisitos

Um aplicativo visualizador CesiumJS em execução — Incorpore Césio em seu aplicativo; expor o conector
Token de acesso de íon de césio (se estiver usando ativos de íon) — https://ion.cesium.com/tokens

Fluxo

Voe para o site

Voe até a Torre Eiffel e coloque um marcador vermelho com o rótulo 'Site A'.✓ Copiado

→ A câmera é animada; marcador aparece com rótulo
Dados de sobreposição

Carregue este GeoJSON dos limites da vizinhança como uma camada translúcida.✓ Copiado

→ Camada visível e interativa
Capturar

Faça uma captura de tela que posso colar no slide.✓ Copiado

→ PNG retornado

Resultado: Uma visualização de briefing ao vivo e vinculável em vez de uma imagem congelada.

Armadilhas

Carregando um enorme GeoJSON sem simplificação — Simplifique para contagens de vértices razoáveis; O césio pode engasgar com polígonos de milhões de vértices

Combine com: filesystem

Animar a trajetória de uma frota ao longo do tempo

👤 Equipes de operações e mobilidade ⏱ ~25 min intermediate

Quando usar: Você tem posições carimbadas com data e hora e deseja uma reprodução no globo.

Pré-requisitos

Dados de posição codificados por tempo — CSV ou GeoJSON com carimbos de data/hora

Fluxo

Carregar entidades com tempo

Adicione 3 entidades de veículo com suas trilhas SampledPositionProperty de Fleet.csv.✓ Copiado

→ Renderização de entidades; a linha do tempo mostra o intervalo
Jogar

Animar em 10x, a câmera segue o veículo A.✓ Copiado

→ Reprodução suave; câmera travada no assunto

Resultado: Reprodução interativa da frota sem escrever código de césio.

Carregue um conjunto de dados de blocos 3D e inspecione um único edifício

👤 Planejamento urbano, AEC, equipes BIM ⏱ ~20 min advanced

Quando usar: Você tem um conjunto de blocos 3D e deseja consultar um recurso.

Fluxo

Carregue o conjunto de peças

Carregue blocos 3D em <URL>, oriente o terreno, defina o erro máximo de espaço na tela 16.✓ Copiado

→ Tileset é renderizado sem combate de profundidade
Destacar + medir

Destaque o edifício na entidade escolhida; medir sua altura.✓ Copiado

→ Edifício em destaque; altura informada

Resultado: Inspeção interativa rápida para revisão das partes interessadas.

Armadilhas

Câmera cortando terreno — Habilite testes de profundidade em terreno; sintonizar clipe próximo/distante

Sobrepor um mapa de calor de dados de pontos

👤 Analistas visualizando densidade ⏱ ~15 min intermediate

Quando usar: Você precisa de um mapa de calor em um mapa sem uma ferramenta de plotagem externa.

Fluxo

Pontos de ingestão

Importe points.csv (lon, lat, peso).✓ Copiado

→ Pontos carregados em um conjunto de ferramentas de mapa de calor
Afinar a aparência

Raio do mapa de calor 25px, gradiente viridis.✓ Copiado

→ Sobreposição estilizada visível

Resultado: Um mapa de calor defensável integrado ao seu globo.

Combine com: mcp-echarts

Combinações

Combine com outros MCPs para 10× de alavancagem

cesium-mcp + filesystem

Carregue conjuntos de dados locais (GeoJSON, CSV) e renderize no mundo

Abra ./data/points.csv, importe como um mapa de calor no globo.✓ Copiado

cesium-mcp + mcp-echarts

Combine o globo 3D com gráficos estatísticos clássicos

Mapa de densidade de césio + histograma de echarts ao lado - filtros sincronizados.✓ Copiado

cesium-mcp + fetch

Obtenha feeds ao vivo (AIS, ADS-B) e anime

Busque posições de embarcações ao vivo e atualize entidades a cada 30 segundos.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
camera.flyTo / lookAt / saveView / loadView	coords / heading / pitch / roll	Navegação da câmera	0
entities.add / update / remove	geometry + styling	Marcadores, rótulos, modelos, polígonos, polilinhas	0
layers.add (GeoJSON / imagery) / toggle	source + style	Alternar ou adicionar camadas geoespaciais	bandwidth for remote sources
tiles3d.load / query	tileset URL	Renderização de blocos 3D e seleção de recursos	0
terrain.set	terrain provider	Trocar provedores de terreno	0
animation.play / trajectory.load	time interval / track	Reprodução baseada em tempo	0
interaction.screenshot / highlight / measure	area or picked entity	Capture, selecione e meça	0
heatmap.add	points + radius + gradient	Visualização de densidade	0
geolocation.goto	name or coords	Navegação por local nomeado	0

Custo e limites

O que custa rodar

Cota de API: Nenhum para o próprio servidor; Os tokens de íons de césio têm sua própria cota se você usar ativos de íons
Tokens por chamada: Pequenas operações; Blocos 3D/bytes de imagens que não estão na contagem de tokens
Monetário: Gratuito – Césio é código aberto
Dica: Fique com as 31 ferramentas principais padrão, a menos que você precise especificamente do conjunto estendido; superfície mais simples = menos curvas erradas.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Token de íon de césio em env var, se usado.

Saída de dados: Busca provedores de imagens/terreno que você configura (Ion, MapBox, servidores de blocos personalizados).

Blocos 3D ou imagens de fontes não confiáveis podem ser executados com privilégios WebGL completos em seu navegador – trate URLs como se fossem scripts.
As capturas de tela podem incluir sobreposições sensíveis; revise antes de compartilhar.

Solução de problemas

Erros comuns e correções

A câmera salta para o espaço em vez do alvo

Verifique a ordem lat/lon (Césio usa lon, lat) e os valores de altitude.

Verificar: Log args passed to camera.flyTo

GeoJSON parece plano

A amostragem do terreno está desativada; habilite clampToGround nas opções de camada.

Verificar: Inspect the layer's styling options

Conjunto de azulejos preto / ausente

CORS bloqueia muitos conjuntos de peças; host ou proxy com cabeçalhos adequados.

Verificar: DevTools Network panel for the tileset URL

Alternativas

Cesium MCP vs. outros

Alternativa	Quando usar	Troca
google-maps	Mapas 2D e API Places são suficientes	Sem globo 3D ou blocos 3D
google-map	Você já está na infra do Google Maps	Menos rico em 3D que o Césio
mcp-echarts	Seus dados são estatísticos, não geoespaciais	Sem contexto de mapa

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills