cesium-mcp-runtime
cesium-mcp-runtime: управление 3D-глобусом CesiumJS из Claude, Cursor и других MCP-клиентов
Что умеет
- Перемещать камеру к координатам с анимацией
- Добавлять GeoJSON-слои с точками, линиями и полигонами
- Наносить текстовые подписи на объекты карты
- Строить тепловые карты и проигрывать траектории
- Загружать 3D Tiles, рельеф и слои изображений
Какие данные видит
Ассистент управляет сценой в браузерной сессии Cesium, без доступа к внешним аккаунтам — данные ограничены загруженными геослоями и настройками карты.
Нужен ли аккаунт
Не нужен: сервер работает без входа
MCP-сервер даёт ассистенту прямой доступ к движку CesiumJS: 59 инструментов для камеры, слоёв, объектов, анимации и сцены на 3D-глобусе. Можно строить GeoJSON-слои с раскраской по значениям, добавлять метки, тепловые карты и траектории движения. Работает через stdio с Claude Desktop, VS Code Copilot и Cursor, а также через Streamable HTTP с Dify и n8n.
Как подключить
Как подключить cesium-mcp-runtime к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://cesium-mcp-runtime--gaopengbin.run.tools
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить cesium-mcp-runtime к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://cesium-mcp-runtime--gaopengbin.run.tools
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить cesium-mcp-runtime к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://cesium-mcp-runtime--gaopengbin.run.tools
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (43)
Технические названия из tools/list. Нужны только разработчикам.
| flyTo | 飞行到指定经纬度位置（带动画过渡） |
| addGeoJsonLayer | 添加 GeoJSON 图层到地图（支持 Point/Line/Polygon，可配置颜色/分级/分类渲染） |
| addLabel | 为 GeoJSON 要素添加文本标注（显示属性值） |
| addHeatmap | 添加热力图图层（基于 GeoJSON 点数据生成热力可视化） |
| removeLayer | 从地图上移除指定图层（按图层ID） |
| setBasemap | 切换底图风格（暗色/卫星影像/标准） |
| screenshot | 截取当前地图视图（返回 base64 PNG） |
| highlight | 高亮指定图层的要素 |
| setView | 瞬间切换到指定经纬度视角（无动画） |
| getView | 获取当前相机视角信息（经纬度、高度、角度） |
| zoomToExtent | 缩放到指定地理范围 |
| addMarker | 在指定经纬度添加标注点，返回 layerId 供后续操作 |
| addPolyline | 在地图上添加折线（路径、线段），返回 entityId |
| addPolygon | 在地图上添加多边形区域（面积、边界），返回 entityId |
| addModel | 在指定经纬度放置 3D 模型（glTF/GLB），返回 entityId |
| updateEntity | 更新已有实体的属性（位置、颜色、标签、缩放、可见性） |
| removeEntity | 移除单个实体（通过 entityId） |
| setLayerVisibility | 设置图层可见性 |
| listLayers | 获取当前所有图层列表（含 ID、名称、类型、可见性） |
| updateLayerStyle | 修改已有图层的样式（颜色、透明度、标注样式等） |
| playTrajectory | 播放移动轨迹动画 |
| load3dTiles | 加载 3D Tiles 数据集（如建筑白膜、城市模型） |
| loadTerrain | 加载或切换地形（平坦/ArcGIS/CesiumIon/自定义 URL） |
| loadImageryService | 加载影像服务图层（WMS/WMTS/XYZ/ArcGIS MapServer） |
| lookAtTransform | 环绕式相机注视某位置（ENU变换 + 朝向/俯仰/距离） |
| startOrbit | 开始相机环绕当前中心旋转 |
| stopOrbit | 停止环绕动画 |
| setCameraOptions | 配置相机控制器（启用/禁用旋转、缩放、倾斜等） |
| addBillboard | 在指定位置添加图片图标 |
| addBox | 添加带尺寸和材质的3D盒体 |
| addCorridor | 添加走廊（带宽度的路径） |
| addCylinder | 添加圆柱体或圆锥体 |
| addEllipse | 添加椭圆 |
| addRectangle | 按地理范围添加矩形 |
| addWall | 沿路径添加墙体 |
| createAnimation | 创建基于时间的路径动画（实体沿路径运动） |
| controlAnimation | 播放或暂停动画 |
| removeAnimation | 删除动画实体 |
| listAnimations | 列出所有活跃的动画 |
| updateAnimationPath | 更新动画路径的可视属性 |
| trackEntity | 相机追踪实体 |
| controlClock | 配置Cesium时钟（时间范围、速度、动画状态） |
| setGlobeLighting | 启用/禁用地球光照和大气效果 |