Mcp Reverse Engineering

mcp-reverse-engineering

A sandboxed MCP (Model Context Protocol) tool for reverse engineering that provides a unified interface to various reverse engineering tools with security restrictions.

[PyPI] [Python] [Ruff][Ask DeepWiki]

Purpose

This project provides a secure, sandboxed environment for executing reverse engineering tools via CLI or MCP protocol. It wraps common reverse engineering utilities (strings, objdump, readelf, binwalk, etc.) with safety features like filesystem isolation, timeouts, and argument validation.

Install

pip install mcp-reverse-engineering

Or for development:

pip install -e ".[dev]"

MCP Server Installation

To use as an MCP server with Claude Desktop:

mcp install src/mcp_reverse_engineering/server.py

Usage

CLI

# Extract strings from a binarymcp-re --tool strings --file /path/to/binary
# Disassemble a binarymcp-re --tool objdump --args "['-d']" --file /path/to/binary
# Analyze ELF headersmcp-re --tool readelf --args "['-h', '-s']" --file /path/to/elf
# Run binwalk for firmware analysismcp-re --tool binwalk --file /path/to/firmware.bin

Python API

from mcp_reverse_engineering import ReverseEngineeringEngine
# Create engine with default configengine = ReverseEngineeringEngine(    workspace="./workspace",    timeout=30,)
# List available toolsprint(engine.list_available_tools())
# Execute a toolresult = engine.execute_tool("strings", ["-n", "8"], "/path/to/binary")print(result)

MCP Server

from mcp_reverse_engineering.server import mcp, strings, objdump, readelf, binwalk
# Run the server (stdio transport for Claude Desktop)if __name__ == "__main__":    mcp.run()

API

ReverseEngineeringEngine

Main class for executing reverse engineering tools.

engine = ReverseEngineeringEngine(    workspace: str = "./workspace",  # Sandbox directory    timeout: int = 30,               # Tool execution timeout    config_path: str | Path | None = None,  # YAML config path)

Methods:

• execute_tool(tool_name: str, args: List[str], file_path: Optional[str] = None) -> str - Execute a tool
• list_available_tools() -> List[str] - List enabled tools
• get_tool_documentation(tool_name: str) -> Dict[str, Any] - Get tool docs
• get_mcp_tools() -> List[Dict[str, Any]] - Get MCP tool schemas

Available Tools

Development

# Clone the repositorygit clone https://github.com/daedalus/mcp_reverse_engineering.gitcd mcp_reverse_engineering
# Install dependenciespip install -e ".[test]"
# Run testspytest
# Format coderuff format src/ tests/
# Lintruff check src/ tests/
# Type checkmypy src/
# Install pre-commit hookspip install pre-commitpre-commit install

MCP Server Configuration

mcp-name: io.github.daedalus/mcp-reverse-engineering

Requirements

• Python 3.11+
• External tools: binwalk, radare2, ghidra, etc. (must be installed separately)

License

MIT