デモ

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