Development - pwno-mcp

This page is for working on pwno-mcp itself, not for debugging a target binary.

Local development

Prerequisites on the host are Python 3.12+, GDB with Python support, and a working pwndbg setup.

uv sync
uv run python -m pwnomcp
uv run python -m pwnomcp --stdio

python -m pip install -e ".[dev]"
python -m pwnomcp
python -m pwnomcp --stdio

Verification commands

uv run black --check .
uv run mypy pwnomcp --ignore-missing-imports --disable-error-code=import-untyped
uv run pytest -v

Docs preview

npm --prefix docs run dev

CI snapshot

Current GitHub Actions run these verification steps before build or publish:

uv sync --locked --extra dev
uv run black --check .
uv run mypy pwnomcp --ignore-missing-imports --disable-error-code=import-untyped
uv run pytest -v