Skip to content

Latest commit

 

History

History
74 lines (45 loc) · 2.32 KB

File metadata and controls

74 lines (45 loc) · 2.32 KB

🌍 Cesium Codegen MCP App

MCP App for generating Cesium views.

video-clip.mp4

Read more about MCP Apps in https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/.

⚙️ Prerequisites

⚙️ Configure

Create .env file based on .env.example and fill required CESIUM_TOKEN, OPENAI_URL and OPENAI_KEY values. Optionally change OPENAI_MODEL if different LLM Model is required. Change HOST_URL to the public domain value if hosting publicly. This is required for CSP.

📦 Installation

pnpm install
pnpm run build

🚀 Running the Server

pnpm start

🛠️ Tools

codegen

Generate and execute code from description

Shows a Cesium viewer generated from provided description.

Input:

  • description Viewer generation request

🔌 Using with AI Clients

The codegen server works with MCP clients that support MCP Apps like Claude Desktop.

MCP App can be tested using Basic Host. Set HOST_URL value in SERVERS environment variable to connect Basic Host to Codegen MCP Server.

🔌 Using code generation directly

An <iframe> generated for MCP App can be used directly without MCP infrastructure like embedding in web pages. Just open the {HOST_URL}/iframe?description={description} url and put the viewer description in {description} query parameter.

🧪 Example Queries

Try these simple commands with your AI client:

"Orbit the great pyramid"
"Fly from Chicago to New York"
"Fly from Chicago to New York with plane"
"Cesium man on top of mount Everest"
"Tour of Paris"
"With day night switch"

🤝 Contributing

Interested in contributing? Please read CONTRIBUTING.md. We also ask that you follow the Code of Conduct.

License

Apache 2.0. See LICENSE.