Log inSubmit server
Cesium MCP logo

Cesium MCP

by gaopengbin

Control CesiumJS maps through MCP with camera navigation, layers, entities, spatial queries, styling, screenshots, and measurements.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Cesium MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "gaopengbin-cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

gaopengbin/cesium-mcp connects MCP-compatible agents to CesiumJS for controlling interactive 3D globes and map scenes. Its tools cover camera movement, GeoJSON and 3D content, entities, layer management, spatial measurements, screenshots, and scene export. The runtime can serve external MCP hosts such as Claude Desktop, Cursor, and Dify, while browser integrations can execute commands directly in a web application. Reach for it when an agent needs to inspect or modify a Cesium view rather than only generate geographic data.

Use cases

  • Navigate a Cesium globe to a requested location or bounding box
  • Add and style GeoJSON, markers, models, routes, and polygons
  • Inspect entities, layer schemas, and geographic feature properties
  • Measure distances or areas on an interactive map
  • Export or capture the current Cesium scene

Key features

  • CesiumJS camera control and saved viewpoints
  • GeoJSON layers and primitive rendering
  • Entity creation, querying, editing, and removal
  • Layer visibility, styling, and basemap switching
  • Screenshots, scene export, and spatial measurement
  • MCP, WebMCP, browser-agent, and function-calling integration paths

Tools33

What Cesium MCP lets your agent do. Expand a tool for its parameters.

Verified live~7.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

7/7 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · cesium-mcp-runtime (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars146Stargazers on the source repository.
npm downloads936Package downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Tools exposed33Callable tools this server registers over MCP.
Directory activity11 viewsConfig copies, upvotes, and views on AllMCPs.

How Cesium MCP works

What gaopengbin/cesium-mcp does

gaopengbin/cesium-mcp exposes CesiumJS map and globe operations to AI agents through MCP and related integration paths. Agents can move the camera, inspect its current position, save and restore page-local viewpoints, and zoom to geographic extents. They can also create, inspect, modify, and remove map content in the active Cesium scene.

The project separates the Cesium command executor from protocol adapters. Its browser-side bridge handles the Cesium operations, while MCP runtime, WebMCP, browser-agent, and function-calling integrations provide different ways to invoke those operations. The repository describes the MCP runtime as the option for external hosts, including Claude Desktop, Cursor, and Dify.

How it works

The browser bridge is the execution core and communicates with a CesiumJS Viewer. Tool definitions and JSON Schemas are maintained separately in the contracts package. Depending on the integration, commands can be invoked in the page by a browser agent, through the browser's document.modelContext WebMCP interface, from application function calling, or through the MCP runtime using WebSocket and JSON-RPC.

For a direct browser trial, the project links to a hosted browser-agent demo that requires no installation or signup. External MCP hosts use the local runtime. The repository also provides a Codex map plugin that can be added from its community source:

text
codex plugin marketplace add gaopengbin/cesium-mcp --ref main
codex plugin add cesium-map@cesium-community

Setup and configuration

The repository publishes separate packages for the bridge, runtime, WebMCP adapter, contracts, development knowledge base, and browser-agent example. Choose the browser-agent path for a quick browser-based test, WebMCP for page-local browser tools, bridge plus application function calling for an existing web app, or the MCP runtime for external MCP hosts.

Usage statistics are enabled by default. Node-based runtime or development usage can be disabled with CESIUM_TELEMETRY_DISABLED=1. Browser integrations can disable telemetry by setting globalThis.CESIUM_MCP_TELEMETRY_DISABLED = true before browser initialization.

Tools and capabilities

The exposed operations support:

  • Animated and immediate camera changes, camera inspection, bounding-box navigation, saved viewpoints, and scene-state export.
  • Markers, labels, glTF or GLB models, polygons, polylines, entity updates, deletion, batch creation, entity queries, and property inspection.
  • Styled GeoJSON layers, primitive rendering for larger browser datasets, layer listing and schema inspection, visibility changes, styling, removal, and complete scene clearing.
  • Basemap switching, feature highlighting, PNG screenshots returned as base64 data URLs, and distance or area measurement.

GeoJSON support covers Point, LineString, and Polygon layers. Layer and entity operations return structured success, error, and data fields; entity-creation tools return identifiers that can be used for later updates or removal.

Limitations and notes

The local MCP runtime is needed only for external MCP hosts; browser-agent, WebMCP, and function-calling integrations run the same command layer inside the web application. Page-local viewpoints and scene state apply to the current page. Large GeoJSON datasets can use primitive rendering through addGeoJsonPrimitive, while the regular GeoJSON layer tool provides styled layer management.

The Codex map plugin is described as a community beta and requires a compatible MCP Apps host. Demonstration scenes use sample map content, and their example building heights and activity values are not presented as official or surveyed data.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Cesium MCP

gaopengbin/cesium-mcp is an MCP server that connects AI agents to CesiumJS for interactive 3D globe control. Its main tools navigate cameras, manage GeoJSON and other layers, create and query entities, change styling, measure geographic features, capture screenshots, and export scene state.

Use the cesium-mcp-runtime package for external MCP hosts such as Claude Desktop, Cursor, or Dify. For browser use, choose the browser-agent, WebMCP, or function-calling integration instead; the project also provides a hosted browser demo requiring no installation or signup.

Yes, Cursor is listed as an external MCP host for the cesium-mcp-runtime path. The local runtime exposes the Cesium command layer to external MCP clients.

Set `CESIUM_TELEMETRY_DISABLED=1` for Node-based runtime or development use. In browser integrations, set `globalThis.CESIUM_MCP_TELEMETRY_DISABLED = true` before browser initialization.

Yes, it can add styled Point, LineString, and Polygon GeoJSON layers, render GeoJSON as Cesium primitives, list layers, inspect schemas, change visibility or styling, highlight features, and remove layers.

Related MCP servers

All in Data Visualization All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCesium MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/gaopengbin-cesium-mcp?style=directory)](https://allmcps.com/mcp/gaopengbin-cesium-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/gaopengbin-cesium-mcp"><img src="https://allmcps.com/api/badge/gaopengbin-cesium-mcp?style=directory" alt="Cesium MCP on AllMCPs" /></a>