cfast-mcp 0.1.0

MCP server for CFAST (Fire and Smoke Transport), built on top of PyCFAST.

CFAST MCP

An MCP server that lets an LLM build, inspect, run, and analyze CFAST (Consolidated Fire and Smoke Transport, NIST) fire models step by step, via PyCFAST.

It exposes tools to add/update compartments, materials, vents, fires, devices, and surface connections, then run the simulation and read results as bounded summaries.

Installation

Requires Python 3.10+ and CFAST 7.7.0+.

CFAST

Download and install CFAST from the NIST CFAST website or the CFAST GitHub repository, and ensure cfast is on your PATH. If it's installed elsewhere, set the CFAST environment variable to the executable path:

export CFAST="/path/to/your/cfast/executable"

Server

pip install cfast-mcp

Usage

Add the server to your MCP client configuration:

{
  "mcpServers": {
    "cfast": {
      "command": "cfast-mcp",
      "env": { "CFAST": "/path/to/your/cfast/executable" }
    }
  }
}

Or run it directly:

cfast-mcp

Development

git clone https://github.com/bewygs/cfast-mcp.git
cd cfast-mcp
uv sync --extra dev          # install dev dependencies
uv run pytest                # run tests
uv run ruff check --fix .    # lint
uv run ruff format .         # format
uv run mypy src/              # type-check

See CLAUDE.md for architecture and contribution details.