resQ MCP Server

A Staff+ engineered Model Context Protocol (MCP) server for the resQ emergency response system. Integrates with Digital Twin Simulations (DTSOP) and Hybrid Coordination Engine (HCE).

Features

• Tools: Trigger simulations, Get deployment strategies, Validate incidents.

• Resources: Real-time drone status (resq://drones/active), Simulation monitoring (resq://simulations/{id}).

• Prompts: Standardized incident response analysis.

• Async Notifications: Subscriptions for long-running simulation jobs.

• Security: Mock Bearer token auth, Pydantic validation.

Development

Prerequisites

• Python 3.11+

• uv or pip

Setup

cd packages/python/mcp
pip install -e .

Running Locally (STDIO)

Ideal for testing with Claude Desktop or MCP Inspector.

# Set env var if needed, or rely on defaults
python -m resq_mcp.server

Running Locally (SSE / HTTP)

# Starts SSE server on port 8000
python -m resq_mcp.server --transport sse --port 8000

Note: FastMCP CLI args might vary slightly depending on version.

Configuration

See .env.example or src/resq_mcp/config.py.

• RESQ_API_KEY: Bearer token for auth (default: resq-dev-token).

• RESQ_SAFE_MODE: Disable side-effects (default: True).

Deployment

Dockerized for Kubernetes.

docker build -t resq-mcp .
kubectl apply -f deployment/k8s.yaml

Security

See SECURITY.md for threat model and details.