# CesiumDesign

> Framework-neutral Cesium effects SDK for WebGIS dashboards, digital twins, and AI-assisted geospatial visualizations.

- **Type:** MCP server
- **Install:** `agentstack add mcp-tzxzhaohao-cesiumdesign`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tzxzhaohao](https://agentstack.voostack.com/s/tzxzhaohao)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tzxzhaohao](https://github.com/tzxzhaohao)
- **Source:** https://github.com/tzxzhaohao/cesiumDesign
- **Website:** https://tzxzhaohao.github.io/cesiumDesign/

## Install

```sh
agentstack add mcp-tzxzhaohao-cesiumdesign
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# geo-effect-kit

Framework-neutral Cesium effects for WebGIS dashboards, emergency command systems, 3D maps, and AI-assisted geospatial applications.

[中文文档](./README.zh-CN.md)

## Features

- Works with an existing Cesium `Viewer`.
- Framework-neutral TypeScript API.
- Reusable effects for radar scans, ripple spread, fly lines, pipe flow, water surfaces, light walls, scan cones, shield domes, temperature fields, GIF fire billboards, scene weather, post-processing, and route flow.
- Common lifecycle API: `update`, `show`, `hide`, `flyTo`, `destroy`.
- Machine-readable manifests for AI agents.
- Optional MCP server for effect discovery and integration examples.

## Install

```bash
pnpm add @ztgkzhaohao/geo-effect-kit cesium
```

Cesium is a peer dependency. The host project owns Cesium versioning, static assets, `CESIUM_BASE_URL`, and Viewer initialization.

## Minimal Usage

```ts
import 'cesium/Build/Cesium/Widgets/widgets.css'
import { Viewer } from 'cesium'
import { createRadarScanEffect } from '@ztgkzhaohao/geo-effect-kit'

const viewer = new Viewer('cesiumContainer')

const radar = createRadarScanEffect(viewer, {
  center: { longitude: 116.391, latitude: 39.907 },
  radiusMeters: 22000,
  color: '#36d6ff',
  scanDurationMs: 3600,
})

radar.flyTo()

// Later, when the layer or page is removed:
radar.destroy()
```

## Available Effects

| Effect | Import | Use case |
| --- | --- | --- |
| Radar scan | `createRadarScanEffect` | Circular radar and warning scans |
| Ripple spread | `createRippleSpreadEffect` | Water, energy, and soft ripple expansion |
| Polyline flow | `createPolylineFlowEffect` | Dispatch routes, data links, migration paths |
| Fly line | `createFlyLineEffect` | High-altitude arcs, hub-spoke links, bidirectional routes |
| Pipe flow | `createPipeFlowEffect` | Water pipes and pressure flow |
| Water surface | `createWaterSurfaceEffect` | Rivers, lakes, flood surfaces, and directional Flow Type water |
| Light wall | `createLightWallEffect` | Security boundaries and protected areas |
| Scan cone | `createScanConeEffect` | Searchlights, sensors, cameras, drones |
| Shield dome | `createShieldDomeEffect` | Protective domes and highlighted regions |
| Temperature field | `createTemperatureFieldEffect` | Risk surfaces and heat fields |
| Fire billboard | `createFireBillboardEffect` | GIF fire markers by longitude/latitude |
| Scene weather | `createSceneWeatherEffect` | Rain, snow, fog, lightning |
| Post process | `createPostProcessEffect` | Bloom, night vision, black-white, brightness, mosaic, depth of field |

## Documentation

- [Getting started](./docs/getting-started.md)
- [Vite and Cesium assets](./docs/vite-cesium.md)
- [React usage](./docs/react.md)
- [Vue usage](./docs/vue.md)
- [AI agents and MCP](./docs/ai-agents.md)
- [Release process](./docs/release.md)

Effect-level manifests and long-form effect notes live in:

- [`knowledge/effects`](./knowledge/effects)
- [`knowledge/docs`](./knowledge/docs)

## Demo

Run locally:

```bash
pnpm install
pnpm --filter geo-effect-kit-demo dev
```

After GitHub Pages is enabled, the public demo will be available at:

```text
https://tzxzhaohao.github.io/cesiumDesign/
```

## AI Agent Usage

AI agents should prefer the structured knowledge files instead of reverse-engineering examples from the demo:

- Use `knowledge/effects/*.effect.json` for effect IDs, imports, options, methods, examples, and notes.
- Use `knowledge/docs/*.md` for effect-specific integration guidance.
- Use `@ztgkzhaohao/geo-effect-kit-mcp` when the agent supports MCP tools.

Start the MCP server:

```bash
npx @ztgkzhaohao/geo-effect-kit-mcp
```

## Development

```bash
pnpm install
pnpm typecheck
pnpm test
pnpm build
```

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [tzxzhaohao](https://github.com/tzxzhaohao)
- **Source:** [tzxzhaohao/cesiumDesign](https://github.com/tzxzhaohao/cesiumDesign)
- **License:** MIT
- **Homepage:** https://tzxzhaohao.github.io/cesiumDesign/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-tzxzhaohao-cesiumdesign
- Seller: https://agentstack.voostack.com/s/tzxzhaohao
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.