mcp-flightrecorder

# MCP Flight Recorder **Version 0.5.17 · Python 3.11+ · SQLite schema 6** MCP Flight Recorder records what an MCP host actually exposes: submitted model input, model tool choices, host dispatch, MCP operations, and tool results submitted back to the model. It keeps these observations and their explicit relationships in a portable SQLite recording. The recorder uses a bounded queue and one capture-time writer thread. Its core and inspection CLI use only the Python standard library. Optional adapters observe existing SDK calls; the host continues to own clients, routing, retries, caches and stream consumption. An accepted capture receipt means the observation entered the queue. It does not promise a durable commit. Missing observations, unavailable attribution and output limits remain explicit. Equal text, tool names, timestamps and provider IDs never establish provenance by themselves. ## Install Use the version pin below to install MCP Flight Recorder from [PyPI](https://pypi.org/project/mcp-flightrecorder/0.5.17/). The core has no third-party runtime dependencies. Select an available supported GIL-enabled CPython once and use the resulting environment for the commands below. The recipe uses `python3` by default. Set `MFR_PYTHON` to choose another supported interpreter. The preflight prints the actual Python and SQLite versions. [Testing](https://github.com/Steady-Hand-AI/mcp-flightrecorder/blob/main/docs/testing.md) distinguishes contributor setup from completed qualification. ```sh mfr_python=$(command -v "${MFR_PYTHON:-python3}") || exit 1 "$mfr_python" -I -B - <<'PYTHON' import sys, sqlite3 assert sys.implementation.name == "cpython" assert sys.version_info[:2] >= (3, 11) assert sys.version_info.releaselevel == "final" assert getattr(sys, "_is_gil_enabled", lambda: True)() assert not sys.flags.optimize print(sys.version, sqlite3.sqlite_version, sys.executable) PYTHON mfr_env=$(mktemp -d /tmp/mfr-env-XXXXXX) "$mfr_python" -m venv "$mfr_env" "$mfr_env/bin…