cesium-mcp
데모
https://github.com/user-attachments/assets/8a40565a-fcdd-47bf-ae67-bc870611c908
Related MCP server: QGIS MCP
패키지 및 진입점
모듈 | 역할 | 상태 | 링크 |
cesium-mcp-bridge | 프로토콜 독립적 명령 디스패처 (60개 이상의 도구) | 메인라인, 활발히 반복 개선 중 |
|
examples/browser-agent | 브라우저 전용 AI 에이전트 (권장 시작점, 백엔드 없음) | 권장 | |
cesium-mcp-runtime | MCP 서버 (stdio + HTTP) | 안정적, 느린 업데이트 |
|
cesium-mcp-dev | 코딩 어시스턴트를 위한 CesiumJS API 지식 베이스 | 유지 관리 중 |
|
어떤 것을 선택할까요? 개인 프로젝트나 빠른 테스트 → browser-agent. AI 어시스턴트를 내장하는 기존 웹 앱 → 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브릿지는 유일하게 필요한 구성 요소입니다. 시나리오에 맞는 드라이버를 선택하세요. 모두 동일한 60개 이상의 도구를 사용합니다.
빠른 시작
경로 0 — 30초 만에 체험하기 (브라우저 에이전트, 권장)
라이브 데모를 열고 OpenAI 호환 API 키를 붙여넣은 뒤 다음과 같이 질문하세요:
"에펠탑으로 날아가서 빨간색 마커를 찍어줘"
examples/browser-agent 폴더를 포크하여 직접 배포하세요.
경로 1 — 자체 웹 앱에 내장하기 (함수 호출)
npm install cesium-mcp-bridgeimport { 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).OpenAI 호환 API를 사용한 전체 루프는 examples/browser-agent/index.html을 참조하세요.
경로 2 — Claude Desktop / Cursor / Dify에서 사용하기 (MCP)
경로 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 3000MCP 클라이언트 설정:
{
"mcpServers": {
"cesium": {
"command": "npx",
"args": ["-y", "cesium-mcp-runtime"]
}
}
}58개의 사용 가능한 도구
도구는 12개의 도구 세트로 구성되어 있습니다. 기본 모드는 4개의 핵심 도구 세트(약 31개 도구)를 활성화합니다. 모든 도구를 사용하려면 CESIUM_TOOLSETS=all로 설정하거나, AI가 런타임에 도구 세트를 동적으로 발견하고 활성화하도록 하세요.
i18n: 도구 설명은 기본적으로 영어입니다. 중국어의 경우
CESIUM_LOCALE=zh-CN으로 설정하세요.
도구 세트 | 도구 |
view (기본) |
|
entity (기본) |
|
layer (기본) |
|
interaction (기본) |
|
camera |
|
entity-ext |
|
animation |
|
tiles |
|
trajectory |
|
heatmap |
|
scene |
|
geolocation |
|
CesiumGS 공식 MCP 서버와의 관계:
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}
세그먼트 | 의미 | 예시 |
| CesiumJS 버전 추적 — Cesium |
|
| MCP 패치 — 새로운 도구, 버그 수정, 문서에 대한 독립적인 반복 개선 |
|
CesiumJS가 새로운 마이너 버전을 릴리스하면(예: 1.140), 그에 맞춰 1.140.0으로 업데이트합니다.
관련 프로젝트
mapbox-mcp — Mapbox GL JS를 위한 AI 제어
openlayers-mcp — OpenLayers를 위한 AI 제어
Star History
라이선스
Available Tools
41 toolsaddGeoJsonLayerB
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
clearAllADestructiveIdempotent
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).
deleteResourceBDestructiveIdempotent
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_toolsetAIdempotent
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.
exportSceneARead-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
flyToAIdempotent
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
getEntityPropertiesARead-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
getLayerSchemaARead-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
getSelectedTileFeatureARead-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
getViewARead-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
highlightAIdempotent
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
listLayersARead-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
listResourcesARead-onlyIdempotent
List resource metadata for the current browser or MCP session without returning payloads.
Inputs: sessionId. Returns: resources
listSessionsARead-onlyIdempotent
List all connected browser sessions (ID and connection state) for multi-browser routing
Inputs: no named parameters.
list_toolsetsARead-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.
listViewpointsARead-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
loadViewpointAIdempotent
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 MapARead-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.
queryEntitiesARead-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
removeEntityADestructiveIdempotent
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
removeLayerADestructiveIdempotent
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
saveViewpointAIdempotent
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
screenshotARead-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
setBasemapAIdempotent
Switch the visible basemap style. Returns { success, data: { basemap }, message? }.
Inputs: url, token, basemap, sessionId. Returns: data, error, message, success
setLayerVisibilityAIdempotent
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
setViewAIdempotent
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
updateEntityBIdempotent
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
updateLayerStyleBIdempotent
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
zoomToExtentAIdempotent
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
Scored across 41 tools
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.
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.
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.
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
Related MCP Connectors
Geospatial AI MCP server — satellite imagery, embeddings, weather, GNS governance
Real-time planetary signal engine and Model Context Protocol (MCP) server for autonomous AI agents.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Geocoding, routing, isochrones, traffic, weather, and place search for AI agents. 19 MCP tools.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables 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
- AlicenseAqualityDmaintenanceConnect 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.1001MIT
- AlicenseNot gradedqualityDmaintenanceConnects 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
- AlicenseNot gradedqualityDmaintenanceEnables 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