# 🚨 EmergencyOps Disaster Response & Incident Dispatch MCP Server

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![Protocol](https://img.shields.io/badge/MCP-1.0.0-green.svg)](https://modelcontextprotocol.io)
[![Domain](https://img.shields.io/badge/Domain-Disaster%20Response-red.svg)](https://ndrf.gov.in/)

A Model Context Protocol (MCP) server that connects LLM agents to active seismic sensors, emergency route logistics, and first-responder team dispatch channels.

---

## 🧰 Available MCP Tools

This server exposes **3 tools** over standard I/O (stdio) transport:

### 1. `get_seismic_activity`
Retrieves live seismograph data, epicenters, richter magnitudes, and depth logs.

### 2. `route_emergency_vehicle`
Calculates fast routes and ETAs for emergency ambulance transit and police dispatch vectors.
* **Parameters**:
  - `current_lat` *(float, required)*: Starting latitude.
  - `current_lon` *(float, required)*: Starting longitude.
  - `destination_lat` *(float, required)*: Destination latitude.
  - `destination_lon` *(float, required)*: Destination longitude.

### 3. `dispatch_first_responders`
Dispatches rescue personnel, NDRF teams, and fire crews to emergency sectors.
* **Parameters**:
  - `sector_id` *(string, required)*: Target area.
  - `incident_type` *(string, required)*: Nature of the emergency (e.g. `"Wildfire"`, `"Earthquake"`).
  - `severity` *(string, required)*: Severity tier (e.g. `"Critical"`, `"Moderate"`).

---

## 📦 Installation & Quickstart

```bash
# 1. Setup environment
cd emergencyops-mcp-server
python -m venv venv
.\venv\Scripts\activate

# 2. Install package
pip install -e .
```

### Claude Desktop Config
```json
{
  "mcpServers": {
    "emergencyops": {
      "command": "D:/Projects/emergencyops-mcp-server/venv/Scripts/python.exe",
      "args": [
        "-m",
        "emergencyops_mcp.server"
      ]
    }
  }
}
```

---

## 🧪 Testing

```bash
python -m pytest -o pythonpath=src
```