mcpField
M
mcp-pwntools

mcp-pwntools

Local
github.com/daedalusSecurity1Updated 26w ago
Repository

About mcp-pwntools

mcp-pwntools exposes pwntools 4.15.0 capabilities as MCP tools for binary exploitation tasks. Its tools cover binary data handling, assembly, ELF files, process interaction, ROP, and exploit utilities.

Key features

  1. 01Pack and unpack binary values
  2. 02Assemble and disassemble instructions
  3. 03Generate shellcode
  4. 04Read and modify ELF files
  5. 05Interact with processes and remote endpoints
  6. 06Load ROP data and build payloads

Use cases

  1. 01Convert values to binary representations
  2. 02Inspect or modify ELF files
  3. 03Create shellcode for an exploitation task
  4. 04Interact with a process or remote service

MCP support

The MCP server exposes pwntools tools and resources to MCP clients, including ELF information and the current pwntools context.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "daedalus-mcp-pwntools": {
      "command": "uvx",
      "args": [
        "mcp-pwntools"
      ]
    }
  }
}
Run commanduvx mcp-pwntools

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-pwntools0.1.0

Tools

40

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
nintegerYesInteger to pack (0-255).

Details

From the project README

mcp-pwntools

MCP server exposing pwntools 4.15.0 functionality for binary exploitation tasks.

PyPI PythonAsk DeepWiki

Install

pip install mcp-pwntools

MCP Server

This package exposes pwntools functionality via the MCP (Model Context Protocol).

Tools

The server provides the following tool categories:

  • Packing/Unpacking: p8, p16, p32, p64, u8, u16, u32, u64, flat
  • Assembly/Disassembly: asm, disasm
  • Shellcode Generation: shellcraft, shellcraft_setreuid, shellcraft_dupsh
  • ELF Manipulation: elf_load, elf_asm, elf_read, elf_write
  • Process Interaction: process_create, remote_connect, listen
  • ROP: rop_load, rop_call
  • Exploitation: fmtstr_payload, fmtstr_split
  • Utilities: hexdump, cyclic, cyclic_find, fit, enhex, unhex, context_set, context_get
  • Logging: log_debug, log_info, log_success, log_warn, log_error
Resources
  • elf://<path> - Load ELF file information
  • context://settings - Get current pwntools context
Usage

Run the MCP server:

mcp-pwntools
Configuration (mcp.json)
{
  "mcpServers": {
    "pwntools": {
      "command": "mcp-pwntools",
      "env": {}
    }
  }
}

Development

git clone https://github.com/daedalus/mcp-pwntools.git
cd mcp-pwntools
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

mcp-name

mcp-name: io.github.daedalus/mcp-pwntools

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.