Skip to content

Installation

mcpwn is a Python package managed with uv. You need uv and Python 3.10+.

Installs the mcpwn command into its own isolated environment and puts it on your PATH:

uv tool install git+https://github.com/D0rs4n/mcpwn
mcpwn --help
  • Pin a ref with @, e.g. uv tool install git+https://github.com/D0rs4n/mcpwn@main.
  • Update later with uv tool upgrade mcpwn.
  • Remove with uv tool uninstall mcpwn.

Run an ephemeral copy straight from git — nothing is added to your PATH:

uvx --from git+https://github.com/D0rs4n/mcpwn mcpwn enum http://127.0.0.1:8765/mcp/

git clone https://github.com/D0rs4n/mcpwn && cd mcpwn
uv sync                 # create the venv and install dependencies
uv run mcpwn --help     # run from the source tree
# or expose the command on your PATH from the local checkout:
uv tool install .

Dropping the uv run prefix

Examples throughout these docs use uv run mcpwn … so they work from a source checkout. If you installed the command with uv tool install, just run mcpwn … instead.

Verify the install

mcpwn --version
mcpwn --help

You should see the version string and the list of subcommands (enum, call, prompt, read, info, ping, shell, sqlmap).

Next: head to the Quickstart and drive the bundled vulnerable server.