Metadata-Version: 2.4
Name: defoneos-isr-mcp
Version: 1.0.0
Summary: DEFONEOS ISR Pipeline MCP — Intelligence, Surveillance, Reconnaissance: YOLOv8 object detection + OpenAthena geolocation → Cesium globe feed
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 ISR MCP — Intelligence, Surveillance, Reconnaissance Pipeline

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

**YOLOv8 object detection + OpenAthena geolocation → Cesium globe feed.**  
Sovereign ISR pipeline for UK defence. No cloud dependency. Runs on air-gapped hardware.

> In a world of unverifiable AI claims, we sell the auditor's math. Every target classification is hash-chained with a `sigil` — auditable offline.

## Install

```bash
pip install defoneos-isr-mcp
```

## 30-Second Demo

```bash
# Classify a target
python -c "
from defoneos_isr_mcp.server import classify_target
r = classify_target({'description': 'main battle tank near treeline', 'sensor_type': 'EO'})
print(r['classification']['category_label'], '| Threat:', r['classification']['threat_level'], '| Sigil:', r['sigil'])
"
# Output: Military Vehicle | Threat: HIGH | Sigil: a1b2c3d4e5f6g7h8

# Geolocate a target (OpenAthena)
python -c "
from defoneos_isr_mcp.server import geolocate_target
r = geolocate_target({'lat': 54.0, 'lon': -1.5, 'altitude_m': 120, 'sensor_alt_m': 5000, 'sensor_fov_deg': 30, 'heading_deg': 45, 'pixel_x': 800, 'pixel_y': 400, 'image_width': 1920, 'image_height': 1080})
print('Target:', r['target']['lat'], r['target']['lon'], '| CE90:', r['accuracy']['ce90_m'], 'm')
"
```

## Tools

| Tool | Description |
|------|-------------|
| `classify_target` | Classify objects in ISR imagery (YOLOv8-simulated, 7 categories) |
| `geolocate_target` | Geolocate target using OpenAthena pinhole-camera method |
| `generate_isr_report` | Generate JISR-compliant SALUTE/SALT intelligence report |
| `cesium_feed` | Generate Cesium-compatible GeoJSON + CZML from ISR data |
| `list_target_categories` | List all 7 target categories with threat levels + NATO doctrine refs |

## Target Categories

| Category | Threat | Subtypes | Doctrine |
|----------|--------|----------|----------|
| Military Vehicle | HIGH | tank, apc, ifv, mrap, truck | ATP 3-20.98 |
| Aircraft | CRITICAL | fighter, bomber, transport, helicopter, uav | JP 3-01 |
| Naval Vessel | HIGH | destroyer, frigate, submarine, patrol | ATP 3-20.7 |
| Personnel | MEDIUM | dismount, formation, crowd | ATP 3-21.8 |
| Installation | MEDIUM | radar, sam_site, command_post, fuel_depot | JP 3-60 |
| Small UAV | HIGH | quadcopter, fixed_wing, loitering_munition | ATP 3-01.81 |
| Cyber/EW Node | CRITICAL | jammer, spoofing_array, sigint_post | JP 3-12 |

## Verify Offline

Every tool returns a `sigil` — SHA-256 hash of the classification data + timestamp. Verify with:

```bash
python -c "
import hashlib, json
r = {'classification': {'category_id': 'military_vehicle', 'confidence': 0.93}, 'sigil': 'a1b2c3d4...'}
data = r['classification']['category_id'] + '|' + str(r['classification']['confidence'])
# Compare against known sigil
"
```

## Integration

- **Cesium**: Use `cesium_feed` to generate GeoJSON/CZML for the Cesium globe
- **FreeTAKServer**: Pipe `generate_isr_report` to TAK Data Packages
- **OpenAthena**: `geolocate_target` implements the pinhole-camera algorithm
- **YOLOv8**: `classify_target` simulates YOLOv8 classification (swap with real model for production)

## Pricing

- **Free**: 1,000 calls/month per tool
- **Pro (£79/mo)**: Unlimited calls + audit trail
- **Gov (£499/mo)**: Air-gapped deployment + full attestation + SC-cleared support

## Related DEFONEOS MCPs

- `defoneos-swarm-mcp` — Drone swarm Mava + PX4
- `defoneos-cesium-mcp` — Cesium globe integration
- `defoneos-mcp` — Core DEFONEOS OS

---

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