cesium-mcp

Демо

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

Пакеты

Архитектура

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. Установите мост (bridge) в ваше приложение 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. Подключите ваш ИИ-агент

Добавьте в конфигурацию вашего MCP-клиента (например, Claude Desktop):

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

Теперь попросите ваш ИИ: "Fly to the Eiffel Tower and add a red marker" (Полети к Эйфелевой башне и добавь красный маркер)

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

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

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

Связь с официальными MCP-серверами CesiumGS: Наборы инструментов camera, entity-ext и animation нативно объединяют возможности CesiumGS/cesium-mcp-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 выпускает новую минорную версию (например, 1.140), мы будем обновлять версию соответствующим образом: 1.140.0.

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

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

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

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

Лицензия

MIT