데모

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

패키지

패키지	설명	npm
cesium-mcp-bridge	브라우저 SDK — CesiumJS 앱에 내장되어 WebSocket을 통해 명령 수신
cesium-mcp-runtime	MCP 서버 (stdio + HTTP) — 58개 도구 (12개 툴셋) + 2개 리소스, 동적 검색
cesium-mcp-dev	IDE MCP 서버 — 코딩 어시스턴트를 위한 CesiumJS API 도우미

아키텍처

flowchart LR
  subgraph clients ["AI Clients"]
    A["Claude / Cursor\nVS Code"]
    D["Dify / n8n\nRemote MCP"]
  end

  subgraph server ["cesium-mcp-runtime\n(Node.js)"]
    R["MCP Server\n58 tools · 12 toolsets"]
  end

  subgraph browser ["Browser"]
    B["cesium-mcp-bridge"]
    C["CesiumJS Viewer"]
  end

  A -- "stdio / MCP" --> R
  D -- "Streamable HTTP" --> R
  R -- "WebSocket\nJSON-RPC" --> B
  B --> C

  style clients fill:#1e293b,stroke:#528bff,color:#e2e8f0
  style server fill:#1e293b,stroke:#155EEF,color:#e2e8f0
  style browser fill:#1e293b,stroke:#12B76A,color:#e2e8f0

빠른 시작

1. CesiumJS 앱에 브리지 설치

npm install cesium-mcp-bridge

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

const bridge = new CesiumBridge(viewer);

2. MCP 런타임 시작

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

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

3. AI 에이전트 연결

MCP 클라이언트 설정(예: Claude Desktop)에 추가하세요:

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

이제 AI에게 다음과 같이 요청해보세요: "에펠탑으로 이동해서 빨간색 마커를 추가해줘"

58개의 사용 가능한 도구

도구는 12개의 툴셋으로 구성되어 있습니다. 기본 모드에서는 4개의 핵심 툴셋(약 31개 도구)이 활성화됩니다. 모든 도구를 사용하려면 CESIUM_TOOLSETS=all로 설정하거나, AI가 런타임에 툴셋을 동적으로 검색하고 활성화하도록 할 수 있습니다.

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`

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}

세그먼트	의미	예시
`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으로 업데이트합니다.

스타 히스토리

라이선스

MIT

cesium-mcp

데모

패키지

아키텍처

빠른 시작

1. CesiumJS 앱에 브리지 설치

2. MCP 런타임 시작

3. AI 에이전트 연결

58개의 사용 가능한 도구

예제

개발

버전 정책

관련 프로젝트

스타 히스토리

라이선스

Resources

Tools

Latest Blog Posts

MCP directory API