Cesium MCP MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

58 инструментов в 12 наборах инструментов
Управление камерой и точкой обзора (облет, просмотр, сохраненные виды)
Entity CRUD — маркеры, метки, 3D-модели, полигоны, полилинии.
Слои — GeoJSON, базовые карты изображений, видимость.
Расширенный — 3D-плитки, ландшафт, анимация, траектории, тепловые карты, геолокация.
Взаимодействие — скриншоты, выделение, измерение

Живое демо

Как выглядит на практике

cesium-mcp.replay ▶ готово

0/0

Установка

Выберите клиент

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

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

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

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

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

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

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

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

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

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

Добавьте в context_servers. Zed перезагружается автоматически.

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

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Cesium MCP

Проведите брифинг по локации на живом земном шаре

👤 Команды эксплуатации, логистики и планирования ⏱ ~15 min intermediate

Когда использовать: Вам нужен живой 3D-брифинг вместо статичных слайдов.

Предварительные требования

Запущенное приложение просмотра CesiumJS. — Встройте Цезий в свое приложение; обнажить разъем
Токен доступа Cesium Ion (при использовании активов Ion) — https://ion.cesium.com/tokens

Поток

Перелет на сайт

Летите к Эйфелевой башне и бросьте красный маркер с надписью «Зона А».✓ Скопировано

→ Камера анимирует; появляется маркер с меткой
Наложение данных

Загрузите этот GeoJSON границ окрестностей как полупрозрачный слой.✓ Скопировано

→ Слой видимый и интерактивный
Захватывать

Сделайте скриншот, который я могу вставить на слайд.✓ Скопировано

→ PNG вернулся

Итог: Живое, связанное представление брифинга вместо замороженного изображения.

Подводные камни

Загрузка огромного GeoJSON без упрощений — Упростите до разумного количества вершин; Цезий может подавиться многоугольниками с миллионом вершин

Сочетать с: filesystem

Анимируйте траекторию движения флота с течением времени

👤 Оперативные и мобильные группы ⏱ ~25 min intermediate

Когда использовать: У вас есть временные метки позиций и вы хотите воспроизвести их на земном шаре.

Предварительные требования

Данные о положении с временной кодировкой — CSV или GeoJSON с отметками времени.

Поток

Загрузка объектов со временем

Добавьте 3 объекта транспортных средств с их треками SampledPositionProperty из файла Fleet.csv.✓ Скопировано

→ Сущности рендерятся; временная шкала показывает интервал
Играть

Анимируйте с увеличением 10x, камера следует за автомобилем А.✓ Скопировано

→ Плавное воспроизведение; камера заблокирована на объекте

Итог: Интерактивное воспроизведение автопарка без написания кода Cesium.

Загрузите набор данных 3D Tiles и осмотрите одно здание.

👤 Команды городского планирования, AEC, BIM ⏱ ~20 min advanced

Когда использовать: У вас есть набор тайлов 3D Tiles и вы хотите запросить объект.

Поток

Загрузите набор плиток

Загрузите 3D-плитки по <URL>, сориентируйте местность, установите максимальную ошибку экранного пространства 16.✓ Скопировано

→ Tileset рендерится без борьбы за глубину
Выделить + измерить

Выделите здание у выбранного объекта; измерьте его высоту.✓ Скопировано

→ Здание выделено; высота указана

Итог: Быстрая интерактивная проверка для рассмотрения заинтересованными сторонами.

Подводные камни

Камера проходит сквозь местность — Включить тестирование глубины на местности; настроить ближний/дальний клип

Наложение тепловой карты точечных данных

👤 Аналитики визуализируют плотность ⏱ ~15 min intermediate

Когда использовать: Вам нужна тепловая карта на карте без внешнего инструмента построения.

Поток

Точки приема

Импортируйте точки.csv (долгота, широта, вес).✓ Скопировано

→ Точки, загруженные в набор инструментов тепловой карты
Тюнинг внешнего вида

Радиус тепловой карты 25 пикселей, градиент зеленого цвета.✓ Скопировано

→ Видно стилизованное наложение

Итог: Надежная тепловая карта, встроенная в ваш глобус.

Сочетать с: mcp-echarts

Комбинации

Сочетайте с другими MCP — эффект x10

cesium-mcp + filesystem

Загружайте локальные наборы данных (GeoJSON, CSV) и визуализируйте на глобусе.

Откройте ./data/points.csv, импортируйте в виде тепловой карты на глобусе.✓ Скопировано

cesium-mcp + mcp-echarts

Соедините 3D-глобус с классическими статистическими диаграммами

Карта плотности цезия + гистограмма Echarts сбоку — синхронизированные фильтры.✓ Скопировано

cesium-mcp + fetch

Получайте прямые трансляции (AIS, ADS-B) и анимируйте

Получайте текущие координаты судов и обновляйте объекты каждые 30 секунд.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
camera.flyTo / lookAt / saveView / loadView	coords / heading / pitch / roll	Навигация по камере	0
entities.add / update / remove	geometry + styling	Маркеры, метки, модели, полигоны, полилинии	0
layers.add (GeoJSON / imagery) / toggle	source + style	Переключить или добавить геопространственные слои	bandwidth for remote sources
tiles3d.load / query	tileset URL	Рендеринг 3D-плиток и выбор функций	0
terrain.set	terrain provider	Поменять поставщиков ландшафта	0
animation.play / trajectory.load	time interval / track	Воспроизведение по времени	0
interaction.screenshot / highlight / measure	area or picked entity	Снимайте, выбирайте и измеряйте	0
heatmap.add	points + radius + gradient	Визуализация плотности	0
geolocation.goto	name or coords	Навигация по названию места	0

Стоимость и лимиты

Во что обходится

Квота API: Нет для самого сервера; Токены Cesium Ion имеют собственную квоту, если вы используете активы Ion.
Токенов на вызов: Малые операции; Байты 3D-фрагментов/изображений не входят в число токенов
Деньги: Бесплатно — Цезий имеет открытый исходный код.
Совет: Придерживайтесь 31 основного инструмента по умолчанию, если только вам не нужен расширенный набор; более простая поверхность = меньше неправильных поворотов.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Токен иона цезия в переменной окружения, если он используется.

Исходящий трафик: Отправляет данные поставщикам изображений/рельефа, которые вы настраиваете (Ion, MapBox, пользовательские серверы тайлов).

3D-плитки или изображения из ненадежных источников могут работать с полными привилегиями WebGL в вашем браузере — относитесь к URL-адресам как к сценариям.
Снимки экрана могут включать конфиденциальные наложения; просмотрите, прежде чем поделиться.

Устранение неполадок

Частые ошибки и исправления

Камера прыгает в пространство вместо цели

Проверьте порядок широты и долготы (Цезий использует долготу, широту) и значения высоты.

Проверить: Log args passed to camera.flyTo

GeoJSON выглядит плоским

Выборка местности отключена; включите зажимToGround в настройках слоя.

Проверить: Inspect the layer's styling options

Тайлсет черный/отсутствует

CORS блокирует многие наборы тайлов; хост или прокси с правильными заголовками.

Проверить: DevTools Network panel for the tileset URL

Альтернативы

Cesium MCP в сравнении

Альтернатива	Когда использовать	Компромисс
google-maps	Достаточно 2D-карт и Places API.	Нет 3D-глобуса или 3D-плиток.
google-map	Вы уже есть на Картах Google ниже	Менее насыщенный 3D, чем Цезий
mcp-echarts	Ваши данные статистические, а не геопространственные	Нет контекста карты

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills