Skip to content

README.md

Latest commit

 

History

History
98 lines (68 loc) · 2.68 KB

README.md

File metadata and controls

98 lines (68 loc) · 2.68 KB
Raw

Cesium MCP App Servers

pnpm monorepo containing Cesium MCP Apps for AI assistants.

📦 Packages

Package Description Port
@cesium-mcp-apps/codegen Cesium views code generation 3001

🛠️ MCP Servers

🎥 cesium-codegen

MCP App for generating Cesium views.

Tool Description
codegen Generate Views from provided description

🏗️ Structure

mcp-apps/
├── codegen/                 # @cesium-mcp/codegen
├── package.json             # pnpm workspace root
└── pnpm-workspace.yaml

🚀 Quick Start

Prerequisites

Install & Build

# From this directory
pnpm install

# Build all packages in dependency order
pnpm run build

💻 Build Commands

pnpm run build              # Build everything
pnpm run build:codegen      # @cesium-mcp-apps/codegen only
pnpm run clean              # Remove all build artifacts

▶️ Running

MCP Servers

pnpm run start:codegen     # Codegen server on port 3001

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 MCP Server.

🏛️ Architecture

sequenceDiagram
    AI Assistant ->>+ MCP Server: Tool request
    MCP Server -->>- AI Assistant: UI resource uri
    AI Assistant ->>+ MCP Server: Resource request
    MCP Server -->>- AI Assistant: iframe contents
    AI Assistant ->> iframe: Show iframe
    iframe ->>+ MCP Server: Tool request
    MCP Server -->>- iframe: Tool response
    iframe ->>+ External resources: request
    External resources -->>- iframe: response
Loading
  1. AI assistant calls MCP tool.
  2. MCP tool returns associated UI component resource in _meta.ui.resourceUri.
  3. AI assistant downloads associated resource.
  4. AI assistant shows resource contents as a webpage in iframe.
  5. iframe script calls MCP tool.
  6. MCP tool returns result to iframe
  7. iframe renders, external requests can optionally be made.

🤝 Contributing

See the root CONTRIBUTING.md for guidelines.

📄 License

Apache-2.0 — see LICENSE.