Skip to main content
Glama

Демо

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

Related MCP server: QGIS MCP

Пакеты и точки входа

Модуль

Роль

Статус

Ссылки

cesium-mcp-bridge

Диспетчер команд, не зависящий от протокола (60+ инструментов)

Основной, активно развивается

npm · исходный код

examples/browser-agent

ИИ-агент только для браузера (рекомендуемая точка входа, без бэкенда)

Рекомендуется

пример · демо

cesium-mcp-runtime

MCP-сервер (stdio + HTTP)

Стабильный, редкие обновления

npm · исходный код

cesium-mcp-dev

База знаний API CesiumJS для ИИ-помощников

Поддерживается

npm · исходный код

Что выбрать? Личный проект или быстрый тест → browser-agent. Существующее веб-приложение с ИИ-помощником → bridge + ваш собственный вызов функций. Использование из Claude Desktop / Cursor / Dify → MCP runtime.

Архитектура

flowchart LR
  subgraph clients ["AI Drivers (pick one)"]
    BA["Browser Agent\n(in the same page)"]
    FC["Your web app\nfunction calling"]
    MCP["Claude / Cursor / Dify\nvia MCP runtime"]
  end

  subgraph core ["cesium-mcp-bridge (browser)"]
    B["60+ tools\nprotocol-agnostic dispatcher"]
    C["CesiumJS Viewer"]
  end

  BA -- "in-page call" --> B
  FC -- "in-page call" --> B
  MCP -- "WebSocket / JSON-RPC" --> B
  B --> C

  style clients fill:#1e293b,stroke:#528bff,color:#e2e8f0
  style core fill:#1e293b,stroke:#12B76A,color:#e2e8f0

Bridge — это единственный обязательный компонент. Выберите драйвер, который соответствует вашему сценарию — все они используют одни и те же 60+ инструментов.

Быстрый старт

Путь 0 — Попробуйте за 30 секунд (браузерный агент, рекомендуется)

Откройте демо, вставьте API-ключ, совместимый с OpenAI, и спросите:

"Fly to the Eiffel Tower and drop a red marker"

Сделайте форк папки examples/browser-agent, чтобы развернуть свою версию.

Путь 1 — Встраивание в ваше веб-приложение (вызов функций)

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

const bridge = new CesiumBridge(viewer);
// Then: send the bridge's tool schema to any LLM that supports function/tool calling,
// route the model's tool calls to bridge.execute(name, params).

Смотрите examples/browser-agent/index.html для примера полного цикла с API, совместимыми с OpenAI.

Путь 2 — Использование из Claude Desktop / Cursor / Dify (MCP)

Установите bridge, как в Пути 1, затем запустите среду выполнения MCP:

# stdio mode (Claude Desktop, VS Code, Cursor)
npx cesium-mcp-runtime

# HTTP mode (Dify, remote/cloud MCP clients)
npx cesium-mcp-runtime --transport http --port 3000

Конфигурация MCP-клиента:

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

58 доступных инструментов

Инструменты организованы в 12 наборов. Режим по умолчанию включает 4 основных набора (~31 инструмент). Установите CESIUM_TOOLSETS=all для доступа ко всему, или позвольте ИИ обнаруживать и активировать наборы инструментов динамически во время выполнения.

i18n: Описания инструментов по умолчанию на английском. Установите CESIUM_LOCALE=zh-CN для китайского.

Набор инструментов

Инструменты

view (по умолчанию)

flyTo, setView, getView, zoomToExtent, saveViewpoint, loadViewpoint, listViewpoints, exportScene

entity (по умолчанию)

addMarker, addLabel, addModel, addPolygon, addPolyline, updateEntity, removeEntity, batchAddEntities, queryEntities, getEntityProperties

layer (по умолчанию)

addGeoJsonLayer, listLayers, removeLayer, clearAll, setLayerVisibility, updateLayerStyle, getLayerSchema, setBasemap

interaction (по умолчанию)

screenshot, highlight, measure

camera

lookAtTransform, startOrbit, stopOrbit, setCameraOptions

entity-ext

addBillboard, addBox, addCorridor, addCylinder, addEllipse, addRectangle, addWall

animation

createAnimation, controlAnimation, removeAnimation, listAnimations, updateAnimationPath, trackEntity, controlClock, setGlobeLighting

tiles

load3dTiles, loadTerrain, loadImageryService, loadCzml, loadKml

trajectory

playTrajectory

heatmap

addHeatmap

scene

setSceneOptions, setPostProcess

geolocation

geocode

Связь с официальными MCP-серверами CesiumGS: Наборы инструментов camera, entity-ext и animation объединяют возможности CesiumGS/cesium-mcp-server (Camera Server, Entity Server, Animation Server) в единую архитектуру моста данного проекта. Это означает, что вы получаете всю официальную функциональность плюс дополнительные инструменты — в одном MCP-сервере, без необходимости запуска нескольких процессов.

Примеры

Смотрите examples/minimal/ для полноценного рабочего демо.

Разработка

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

Политика версий

Формат версии: {CesiumMajor}.{CesiumMinor}.{MCPPatch}

Сегмент

Значение

Пример

1.139

Отслеживает версию CesiumJS — собрано и протестировано с Cesium ~1.139.0

1.139.8 → Cesium 1.139

.8

MCP-патч — независимые итерации для новых инструментов, исправлений ошибок, документации

1.139.7 → 1.139.8

Когда CesiumJS выпускает новую минорную версию (например, 1.140), мы будем обновлять версию соответствующим образом: 1.140.0.

Связанные проекты

  • mapbox-mcp — ИИ-управление для Mapbox GL JS

  • openlayers-mcp — ИИ-управление для OpenLayers

История звезд

Лицензия

MIT

Available Tools

41 tools
addGeoJsonLayerB

Add a styled GeoJSON Point, LineString, or Polygon layer. Returns { success, data: { id, name, type, visible, color, dataRefId? }, message? }; use id with highlight.

Inputs: id, url, data, name, +4 more. Returns: data, error, message, success

addGeoJsonPrimitiveB

Render GeoJSON as Cesium primitives for large browser datasets. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: id, url, data, name, +7 more. Returns: data, error, message, success

addLabelC

Add property-based text labels for GeoJSON features. Returns { success, data: { labelCount: integer }, message? }.

Inputs: field (required), data, style, sessionId, +1 more. Returns: data, error, message, success

addMarkerA

Add a point marker at geographic coordinates. Returns { success, data: { entityId }, message? }; keep entityId for removeEntity.

Inputs: latitude (required), longitude (required), id, size, +3 more. Returns: data, error, message, success

addModelA

Add a glTF or GLB model at geographic coordinates. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: url (required), latitude (required), longitude (required), roll, +6 more. Returns: data, error, message, success

addPolygonA

Draw a polygon area from geographic coordinate tuples. Returns { success, data: { entityId }, message? }; keep entityId for removeEntity.

Inputs: coordinates (required), color, label, opacity, +4 more. Returns: data, error, message, success

addPolylineA

Draw a path or route from geographic coordinate tuples. Returns { success, data: { entityId }, message? }; keep entityId for removeEntity.

Inputs: coordinates (required), color, label, width, +2 more. Returns: data, error, message, success

batchAddEntitiesC

Add multiple supported entities in one page operation. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: entities (required), sessionId. Returns: data, error, message, success

clearAllA
DestructiveIdempotent

Clear all layers, entities, animations, and trajectories from the scene. Returns { success, data: { removedLayers, removedEntities }, message? }.

Inputs: sessionId. Returns: data, error, message, success

connectCesiumMapD

Internal map app transport: connect.

Inputs: sessionId (required).

deleteResourceB
DestructiveIdempotent

Delete one session-scoped resource by resourceId.

Inputs: resourceId (required), sessionId. Returns: removed

disconnectCesiumMapC

Internal map app transport: disconnect.

Inputs: token (required), sessionId (required).

enable_toolsetA
Idempotent

Enable a tool group to make its tools available. Call list_toolsets first to see available groups.

Inputs: toolset (required).

exchangeCesiumMapD

Internal map app transport: exchange.

Inputs: token (required), sessionId (required), results.

exportSceneA
Read-onlyIdempotent

Export the current view, layer, and entity state as JSON. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: sessionId. Returns: data, error, message, success

flyToA
Idempotent

Animate the camera to a geographic location. Use for visible navigation requested by the user. Returns { success: boolean, message?: string, error?: string }.

Inputs: latitude (required), longitude (required), pitch, height, +3 more. Returns: error, message, success

getEntityPropertiesA
Read-onlyIdempotent

Read the properties and graphics metadata for one entity. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: entityId (required), sessionId. Returns: data, error, message, success

getLayerSchemaA
Read-onlyIdempotent

Inspect fields, entity counts, and metadata for a layer. For vector/3D Tiles, metadata.tileStyle returns the applied style expressions. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: layerId (required), sessionId. Returns: data, error, message, success

getSelectedTileFeatureA
Read-onlyIdempotent

Read the last clicked managed vector/3D Tiles feature attributes and layerId. Use updateLayerStyle with that layerId to style it. Returns feature=null when nothing is selected; metadata is a snapshot, not a whole-dataset query. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: sessionId. Returns: data, error, message, success

getViewA
Read-onlyIdempotent

Get the current camera position and orientation. Returns { success, data: { longitude, latitude, height, heading, pitch, roll }, message? }.

Inputs: sessionId. Returns: data, error, message, success

highlightA
Idempotent

Highlight one feature or every feature in a GeoJSON layer. Returns { success: boolean, message?: string, error?: string }.

Inputs: clear, color, layerId, sessionId, +1 more. Returns: error, message, success

listLayersA
Read-onlyIdempotent

List all layers currently managed by the page. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: sessionId. Returns: data, error, message, success

listResourcesA
Read-onlyIdempotent

List resource metadata for the current browser or MCP session without returning payloads.

Inputs: sessionId. Returns: resources

listSessionsA
Read-onlyIdempotent

List all connected browser sessions (ID and connection state) for multi-browser routing

Inputs: no named parameters.

list_toolsetsA
Read-onlyIdempotent

List all available tool groups and their enabled status. Call this to discover additional capabilities before asking the user to configure anything.

Inputs: no named parameters.

listViewpointsA
Read-onlyIdempotent

List camera viewpoints saved in the current page. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: sessionId. Returns: data, error, message, success

loadViewpointA
Idempotent

Restore a previously saved page-local camera state. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: name (required), duration, sessionId. Returns: data, error, message, success

measureA

Measure distance or area between geographic coordinate tuples. Returns { success, data: { mode, value, unit, segments?, id? }, message? }.

Inputs: mode (required), positions (required), id, sessionId, +1 more. Returns: data, error, message, success

openCesiumMapCesium MapA
Read-only

Open an interactive 3D map beside the conversation. Pass the returned sessionId to every map tool. Call once to open the map, then wait until its browser session connects before sending commands. Optionally reopen a known session.

Inputs: sessionId.

queryEntitiesA
Read-onlyIdempotent

Query page entities by name, type, or geographic extent. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: bbox, name, type, sessionId. Returns: data, error, message, success

removeEntityA
DestructiveIdempotent

Remove one entity created by an entity tool. Returns { success, message? } or { success: false, error } when entityId is not found.

Inputs: entityId (required), sessionId. Returns: error, message, success

removeLayerA
DestructiveIdempotent

Remove a managed layer from the page. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: id (required), sessionId. Returns: data, error, message, success

saveViewpointA
Idempotent

Save the current camera state under a page-local name. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: name (required), sessionId. Returns: data, error, message, success

screenshotA
Read-onlyIdempotent

Capture the current Cesium map view as a PNG image. Returns { success, data: { dataUrl, width, height }, message? }; dataUrl is a base64 PNG.

Inputs: sessionId. Returns: data, error, message, success

setBasemapA
Idempotent

Switch the visible basemap style. Returns { success, data: { basemap }, message? }.

Inputs: url, token, basemap, sessionId. Returns: data, error, message, success

setLayerVisibilityA
Idempotent

Show or hide a managed layer. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: id (required), visible (required), sessionId. Returns: data, error, message, success

setViewA
Idempotent

Set the camera position immediately without animation. Use for deterministic setup or instant view changes. Returns { success: boolean, message?: string, error?: string }.

Inputs: latitude (required), longitude (required), roll, pitch, +3 more. Returns: error, message, success

storeResourceA

Store GeoJSON, CZML, or JSON once and return a compact resourceId for later tool calls.

Inputs: data (required), kind (required), sessionId, resourceId, +1 more. Returns: kind, createdAt, expiresAt, sizeBytes, +1 more

updateEntityB
Idempotent

Update the position, appearance, label, visibility, or polygon extrusion height of an entity, including data-source entities. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: entityId (required), show, color, label, +4 more. Returns: data, error, message, success

updateLayerStyleB
Idempotent

Update vector, imagery, primitive, or 3D Tiles styling for a layer. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: layerId (required), sessionId, tileStyle, labelStyle, +3 more. Returns: data, error, message, success

zoomToExtentA
Idempotent

Animate the camera to a west/south/east/north bounding box. Returns { success: boolean, data?: unknown, message?: string, error?: string }.

Inputs: bbox (required), duration, sessionId. Returns: data, error, message, success

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 41 tools

    Disambiguation4/5

    Most tools target clearly distinct resources or actions, and descriptions distinguish similar operations such as entity vs. layer updates. However, addGeoJsonPrimitive vs. addGeoJsonLayer overlap in purpose, and exposed internal transport tools like connectCesiumMap/exchangeCesiumMap could be confused with openCesiumMap.

    Naming Consistency4/5

    The set is predominantly consistent camelCase verb_noun naming (addMarker, updateLayerStyle, removeEntity, flyTo). Minor deviations include snake_case list_toolsets/enable_toolset and a few noun-only or verb-only names like screenshot, highlight, and measure.

    Tool Count2/5

    At 41 tools, the surface is heavy for a single MCP server even though the Cesium map domain is broad. Several tools are internal transport or toolset-management utilities, which adds surface area beyond the core mapping workflow.

    Completeness4/5

    Coverage is broad: sessions, layers, resources, viewpoints, camera control, entity CRUD, styling, measurement, screenshots, basemap, export, and toolset discovery are all present. Minor gaps remain, notably no creation tools for animations/trajectories despite clearAll referencing them, and no import counterpart to exportScene.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables users to search for geographic locations and visualize them on an interactive 3D globe powered by CesiumJS and OpenStreetMap. It provides tools for geocoding addresses and rendering maps with specific bounding boxes through the Model Context Protocol.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Connect QGIS to Claude AI through the Model Context Protocol (MCP), enabling Claude to directly control QGIS — manage layers, edit features, run processing algorithms, render maps, and more.
      100
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants (Claude, Cursor, etc.) to QGIS 4.x via MCP, enabling natural language-driven GIS workflows through 37+ tools, including data loading, processing, and spatial analysis.
      GPL 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to perform geospatial analysis, spatial data processing, vector and raster operations, coordinate transformations, spatial statistics, mapping, and access to climate, satellite, and other geospatial data through MCP-compatible clients.
      MIT