Metadata-Version: 2.4
Name: defoneos-cesium-mcp
Version: 1.0.0
Summary: DEFONEOS Cesium MCP — 3D digital twin globe integration for CesiumJS with GeoJSON/CZML generation
Author-email: "MEOK AI Labs (CSOAI LTD)" <team@meok.ai>
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.28.0
Requires-Dist: pydantic>=2.0
Dynamic: license-file

# DEFONEOS Cesium MCP — 3D Digital Twin Globe

[![PyPI version](https://img.shields.io/pypi/v/defoneos-cesium-mcp.svg)](https://pypi.org/project/defoneos-cesium-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

**CesiumJS 3D digital twin globe for UK defence.** Terrain, entities, CZML generation.

## Install

```bash
pip install defoneos-cesium-mcp
```

## 30-Second Demo

```bash
python -c "
from defoneos_cesium_mcp.server import create_digital_twin, add_entity_layer
t = create_digital_twin({'twin_id': 'yorkshire', 'name': 'Yorkshire COP'})
print(f\"Twin: {t['config']['name']} | Camera: {t['config']['camera']['destination']['height']}m\")
e = add_entity_layer({'twin_id': 'yorkshire', 'name': 'ISR Targets', 'entities': [{'id': 'T1', 'lat': 54.0, 'lon': -1.5, 'type': 'target', 'label': 'Tank'}]})
print(f\"{e['entity_count']} entities loaded\")
"
```

## Tools

| Tool | Description |
|------|-------------|
| `create_digital_twin` | Create Cesium twin config with terrain + imagery |
| `add_terrain_layer` | Add OS Terrain, Sentinel-2, or custom layers |
| `add_entity_layer` | Add ISR targets, drones, sensors, vehicles with CZML |
| `generate_cesium_viewer` | Generate standalone Cesium Viewer HTML page |
| `list_layer_types` | List 6 pre-configured UK base layers |

## Layers

| Layer | Provider | Type |
|-------|----------|------|
| OS Maps API | Ordnance Survey | Raster |
| OS Terrain 5 | Ordnance Survey | 5m DTM |
| Bing Aerial | Microsoft | Imagery |
| OSM Buildings | OpenStreetMap | 3D Tiles |
| Sentinel-2 | ESA | Imagery |
| UK Defence Grid | DEFONEOS | MGRS Overlay |

## Integration

- **ISR Pipeline**: Pipe `defoneos-isr-mcp` → `cesium_feed` → Cesium Viewer
- **Swarm**: `defoneos-swarm-mcp` → `generate_swarm_tak` → Cesium entities
- **FreeTAKServer**: CZML entities map to TAK Data Packages

**MEOK AI Labs (CSOAI LTD)** — Sovereign. British. Forever.
