Skip to main content
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

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