pm3-mcp-server

Servidor Model Context Protocol orientado a Windows que envuelve la CLI de Proxmark3 Iceman/RRG para flujos de trabajo con MIFARE Classic.

No es un paso directo 1:1 de la CLI: la ruta principal es escritura mágica segura — detectar generación de tarjeta → enrutar el comando de escritura correcto → verificar → retroceder en caso de fallo silencioso.

Solo uso autorizado. Úselo en tarjetas y sistemas que posea o para los que tenga permiso explícito de prueba. Las escrituras en tarjetas mágicas y los cambios de UID tienen modos de fallo irreversibles (p. ej., congelación Gen3).

Requisitos

• Windows + cliente Proxmark3 Iceman (proxmark3.exe) ya instalado y flasheado

• Python 3.10+

• Acceso serie al dispositivo (no ejecute la GUI oficial de Proxmark en el mismo puerto COM al mismo tiempo)

Related MCP server: mcp-uart

Configuración

Copie keys.local.json.example → keys.local.json para las claves del sitio (ignorado por git). El servidor solo informa al LLM de los recuentos de claves, nunca de la lista de claves.

Las etiquetas de carpeta del paquete del proveedor (p. ej., V9.0.6.7) son solo etiquetas. La versión real del cliente proviene de pm3_info / proxmark3.exe --version (p. ej., Iceman v4.20142). Este servidor no flashea firmware.

Configuración

git clone https://github.com/wocessade/pm3-mcp-server.git
cd pm3-mcp-server
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
pytest -q

Comprobación rápida del cliente (sin necesidad de tarjeta):

& $env:PM3_EXE_PATH --version

Ejecución

$env:PM3_EXE_PATH = "C:\path\to\proxmark3.exe"
$env:PM3_CWD = "C:\path\to\proxmark3"
$env:PM3_PORT = "COM3"
python server.py

Fragmento MCP para Cursor / Claude

{
  "mcpServers": {
    "pm3": {
      "command": "python",
      "args": ["C:\\path\\to\\pm3-mcp-server\\server.py"],
      "env": {
        "PM3_EXE_PATH": "C:\\path\\to\\proxmark3.exe",
        "PM3_CWD": "C:\\path\\to\\proxmark3",
        "PM3_PORT": "COM3"
      }
    }
  }
}

Prefiera el intérprete del venv si instaló las dependencias allí:

"command": "C:\\path\\to\\pm3-mcp-server\\.venv\\Scripts\\python.exe"

Superficie de herramientas

Principales (use estas primero)

Avanzadas (solo cuando las principales no sean suficientes): pm3_detect_magic, pm3_try_keys, pm3_read_block, pm3_read_sector, pm3_write_block, pm3_set_uid.

Taxonomía de escritura mágica

Las respuestas orientadas al dispositivo incluyen _raw (truncado) para una degradación elegante del análisis.

Pruebas

pytest -q

Cubre fixtures de analizador, bits de acceso (FF078069), enrutador de escritura (Gen3 ≠ `#### 相似三角形，则

**Paghahanapin