Seattle Fire Department MCP Server

MCP SFD - Seattle Fire Department MCP Server

A Model Context Protocol (MCP) server that provides tools for LLMs to fetch and analyze Seattle Fire Department live incident data.

Features

Low-level API proxy (sfd.fetch_raw) with normalization and caching
Latest incident retrieval (sfd.latest_incident) for quick updates
Fire detection (sfd.is_fire_active) with intelligent status analysis
Evacuation monitoring (sfd.has_evacuation_orders) with keyword scanning
Robust error handling and retry logic
Comprehensive data normalization
In-memory caching with configurable TTL

Installation

# Install the package
pip install -e .

# Install development dependencies
pip install -e ".[dev]"

Usage

Running the MCP Server

# Run with default settings
python -m mcp_sfd.server

# Or use the CLI command
mcp-sfd

Environment Variables

SFD_BASE_URL: Base URL for SFD API (default: https://sfdlive.com/api/data/)
DEFAULT_CACHE_TTL: Default cache TTL in seconds (default: 15)

Available Tools

`sfd.fetch_raw`

Low-level proxy for the SFD API with full parameter control.

{
  "order": "new",
  "length": 100,
  "search": "Any",
  "cacheTtlSeconds": 15
}

`sfd.latest_incident`

Returns the single most recent incident.

{}

`sfd.is_fire_active`

Checks if there are any active fire incidents in Seattle.

{
  "lookbackMinutes": 120
}

`sfd.has_evacuation_orders`

Scans for evacuation-related keywords in recent incidents.

{
  "lookbackMinutes": 180
}

Development

Running Tests

# Run all tests
pytest

# Run with coverage
pytest --cov=mcp_sfd

# Run specific test file
pytest tests/test_normalize.py

Code Quality

# Format code
black mcp_sfd/ tests/

# Lint
ruff check mcp_sfd/ tests/

# Type check
mypy mcp_sfd/

Architecture

The server is built with several key components:

HTTP Client (http_client.py): Handles API requests with retry logic and caching
Data Normalization (normalize.py): Converts upstream API format to standardized schemas
Pydantic Schemas (schemas.py): Type-safe data models for all inputs and outputs
Tool Implementations (tools/): Individual MCP tool logic
Server (server.py): MCP server registration and error handling

Data Normalization

The server handles complex data transformations:

Flattens nested upstream data structures
Converts Seattle local time to UTC
Normalizes coordinates from various formats
Parses unit identifiers and status information
Standardizes boolean fields

Error Handling

All tools use standardized MCP error codes:

UPSTREAM_HTTP_ERROR: API connectivity issues
UPSTREAM_TIMEOUT: Request timeouts
SCHEMA_VALIDATION_ERROR: Data parsing failures

License

MIT