> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pwno.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Development

> Local development, verification commands, and docs preview for maintainers.

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.

<CodeGroup>
  ```bash uv theme={null}
  uv sync
  uv run python -m pwnomcp
  uv run python -m pwnomcp --stdio
  ```

  ```bash pip theme={null}
  python -m pip install -e ".[dev]"
  python -m pwnomcp
  python -m pwnomcp --stdio
  ```
</CodeGroup>

## Verification commands

```bash theme={null}
uv run black --check .
uv run mypy pwnomcp --ignore-missing-imports --disable-error-code=import-untyped
uv run pytest -v
```

## Docs preview

```bash theme={null}
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`