/ Каталог / Песочница / Cesium MCP
● Сообщество gaopengbin 🔑 Нужен свой ключ

Cesium MCP

автор gaopengbin · gaopengbin/cesium-mcp

Управление 3D-глобусом CesiumJS на естественном языке — управляйте камерой, перемещайте объекты, переключайте слои, загружайте 3D-фрагменты, анимируйте траектории.

cesium-mcp позволяет клиенту MCP управлять существующей программой просмотра CesiumJS. 58 инструментов в 12 наборах инструментов охватывают навигацию по камере/виду, объекты (маркеры, метки, модели, полигоны, полилинии), слои (GeoJSON, базовые карты), взаимодействие (скриншоты, выделение, измерение) и расширенные функции (3D-плитки, ландшафт, анимацию, траектории, тепловые карты, геолокацию). Инструменты Core 31 активируются по умолчанию; установите CESIUM_TOOLSETS=all для полного набора. Соедините его с любым приложением, встроенным в CesiumJS, чтобы получить геопространственную визуализацию на основе искусственного интеллекта.

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

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

Живое демо

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

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
Поток
  1. Перелет на сайт
    Летите к Эйфелевой башне и бросьте красный маркер с надписью «Зона А».✓ Скопировано
    → Камера анимирует; появляется маркер с меткой
  2. Наложение данных
    Загрузите этот GeoJSON границ окрестностей как полупрозрачный слой.✓ Скопировано
    → Слой видимый и интерактивный
  3. Захватывать
    Сделайте скриншот, который я могу вставить на слайд.✓ Скопировано
    → PNG вернулся

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

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

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

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

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

Предварительные требования
  • Данные о положении с временной кодировкой — CSV или GeoJSON с отметками времени.
Поток
  1. Загрузка объектов со временем
    Добавьте 3 объекта транспортных средств с их треками SampledPositionProperty из файла Fleet.csv.✓ Скопировано
    → Сущности рендерятся; временная шкала показывает интервал
  2. Играть
    Анимируйте с увеличением 10x, камера следует за автомобилем А.✓ Скопировано
    → Плавное воспроизведение; камера заблокирована на объекте

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

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

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

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

Поток
  1. Загрузите набор плиток
    Загрузите 3D-плитки по <URL>, сориентируйте местность, установите максимальную ошибку экранного пространства 16.✓ Скопировано
    → Tileset рендерится без борьбы за глубину
  2. Выделить + измерить
    Выделите здание у выбранного объекта; измерьте его высоту.✓ Скопировано
    → Здание выделено; высота указана

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

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

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

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

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

Поток
  1. Точки приема
    Импортируйте точки.csv (долгота, широта, вес).✓ Скопировано
    → Точки, загруженные в набор инструментов тепловой карты
  2. Тюнинг внешнего вида
    Радиус тепловой карты 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, пользовательские серверы тайлов).

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

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

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

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

Проверить: 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