gaopengbin/cesium-mcp

> ## 📣 作者正在求职 · 北京
>
> **AI 应用开发 · Agent 应用开发 · AI 产品全栈**
>
> 我是高鹏彬，有约 6 年软件开发经验。如果你们团队正在招人，欢迎联系，也感谢帮忙内推或转发！
>
> ### 📄 查看简历 PDF　·　✉️ 联系我
>
> 查看我的项目与个人介绍 → · 邮箱：**1804287165@qq.com**
> [!TIP]
> **📣 Built with Cesium MCP? / 谁在使用 Cesium MCP？**
>
> Share your project, screenshots, or feedback—work in progress is welcome! / 欢迎分享项目、截图和使用反馈，开发中的作品也欢迎！
>
> **Share / 分享 → Issue #44** · Discussion / 讨论区
A protocol-agnostic Cesium AI control runtime for MCP, WebMCP, function calling, and browser agents
cesium-mcp-bridge is the protocol-agnostic Cesium command executor. Separate adapters expose it to browser-only agents , WebMCP browser agents , function calling , or MCP — your choice.
Four integration paths: Browser Agent (simplest, zero backend) · WebMCP (page-local browser tools) · function calling (embed in your web app) · MCP runtime (Claude Desktop / Cursor / Dify)
The local Runtime is only required for external MCP hosts. Browser Agent, WebMCP, and function-calling integrations execute the same commands directly in the web application.
Try it now — open the live browser demo, no install, no signup.
Website ·
中文 ·
Getting Started ·
API Reference
---
Cesium Map in Codex
Install the hosted map plugin from this repository's **Cesium Map Community** source:
Restart Codex and ask “Open a map of Manhattan.” Uses native host chat, with no local map server or separate model API key. Requires a compatible MCP Apps host. This is a community beta, separate from the OpenAI public directory.
Installation and compatibility · ZIP download · Product website
Continue in native Codex chat
- “Open the New York 3D city blocks scene, change the selected building height to 180 metres, then read it back.”
- “Explain the selected hexagon in the San Francisco city activity scene.”
- “Show the Los Angeles hotspots scene, then zoom in on the route.”
Select a scene in the map, click an object and choose **Ask in Codex** to continue with its map context. The host controls chat placement and map expansion.
Map previews
Actual running screenshot: the development preview is connected to the hosted HTTPS MCP service. The native conversation UI is provided by Codex; it is not pictured here.
| San Francisco · City activity | New York · 3D city blocks | Los Angeles · Hotspots |
| --- | --- | --- |
| | | |
| Inspect feature values and change classification colors | Select buildings, edit extrusion heights and read back properties | Combine a heatmap, markers and connecting routes |
These covers come from rendered map scenes. Buildings, activity values and heatmap points are demonstration data, not surveyed heights or official statistics. Basemap imagery: Esri and its imagery contributors.
Demo
https://github.com/user-attachments/assets/8a40565a-fcdd-47bf-ae67-bc870611c908
Packages & Entry Points
| Module | Role | Status | Links |
|--------|------|--------|-------|
| **cesium-mcp-contracts** | Transport-neutral names, descriptions, and JSON Schemas for browser tools | New shared layer | source |
| **cesium-mcp-bridge** | Protocol- and transport-free Cesium command executor (60+ commands) | Mainline, actively iterated | · source |
| **cesium-mcp-webmcp** | One-package Viewer integration plus the native document.modelContext adapter | Browser integration | source |
| **examples/webmcp-integration** | Focused npm + Vite integration without a chat UI or MCP server | Developer example | example |
| **examples/browser-agent** | Browser-only AI agent with automatic WebMCP exposure | Recommended | example · live demo |
| **cesium-mcp-runtime** | MCP server (stdio + HTTP) | Stable MCP SDK v2 | · source |
| **cesium-mcp-dev** | CesiumJS API knowledge base for coding assistants | Maintained | · source |
> **Which one?** Personal project or quick try → browser-agent. Let a compatible browser agent discover page-local Cesium tools → WebMCP. Existing web app embedding an AI assistant → bridge + your own function calling. Calling from Claude Desktop / Cursor / Dify → MCP runtime.