mcp_reverse_engineering

mcp-reverse-engineering

セキュリティ制限を備え、さまざまなリバースエンジニアリングツールへの統一インターフェースを提供する、サンドボックス化されたリバースエンジニアリング用MCP（Model Context Protocol）ツールです。

目的

このプロジェクトは、コマンドラインまたはMCPプロトコル経由でリバースエンジニアリングツールを実行するための、安全なサンドボックス環境を提供します。一般的なリバースエンジニアリングユーティリティ（strings、objdump、readelf、binwalkなど）を、ファイルシステムの分離、タイムアウト、引数の検証といった安全機能とともにラップします。

インストール

pip install mcp-reverse-engineering

開発用の場合：

pip install -e ".[dev]"

MCP サーバーのインストール

Claude DesktopでMCP サーバーとして使用するには：

mcp install src/mcp_reverse_engineering/server.py

使用方法

CLI

# Extract strings from a binary
mcp-re --tool strings --file /path/to/binary

# Disassemble a binary
mcp-re --tool objdump --args "['-d']" --file /path/to/binary

# Analyze ELF headers
mcp-re --tool readelf --args "['-h', '-s']" --file /path/to/elf

# Run binwalk for firmware analysis
mcp-re --tool binwalk --file /path/to/firmware.bin

Python API

from mcp_reverse_engineering import ReverseEngineeringEngine

# Create engine with default config
engine = ReverseEngineeringEngine(
    workspace="./workspace",
    timeout=30,
)

# List available tools
print(engine.list_available_tools())

# Execute a tool
result = engine.execute_tool("strings", ["-n", "8"], "/path/to/binary")
print(result)

MCP サーバー

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

リバースエンジニアリングツールを実行するメインクラスです。

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

メソッド：

• execute_tool(tool_name: str, args: List[str], file_path: Optional[str] = None) -> str - ツールを実行します
• list_available_tools() -> List[str] - 有効なツールを一覧表示します
• get_tool_documentation(tool_name: str) -> Dict[str, Any] - ツールのドキュメントを取得します
• get_mcp_tools() -> List[Dict[str, Any]] - MCPツールのスキーマを取得します

利用可能なツール

ツール	カテゴリ	説明
file	file_tools	ファイルの種類を判定します
strings	file_tools	印字可能な文字列を抽出します
hexdump	file_tools	16進ダンプ
xxd	file_tools	16進ダンプ
objdump	binary_tools	バイナリを逆アセンブルします
readelf	binary_tools	ELFヘッダーを読み取ります
binwalk	firmware_tools	ファームウェアを解析します

開発

# Clone the repository
git clone https://github.com/daedalus/mcp_reverse_engineering.git
cd mcp_reverse_engineering

# Install dependencies
pip install -e ".[test]"

# Run tests
pytest

# Format code
ruff format src/ tests/

# Lint
ruff check src/ tests/

# Type check
mypy src/

# Install pre-commit hooks
pip install pre-commit
pre-commit install

MCP サーバーの設定

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

要件

• Python 3.11+
• 外部ツール：binwalk、radare2、ghidraなど（別途インストールが必要です）

ライセンス

MIT