pm3-mcp-server

Windows-orientierter Model Context Protocol-Server, der die Proxmark3 Iceman/RRG-CLI für MIFARE-Classic-Workflows kapselt.

Kein reiner 1:1-CLI-Durchgriff: Der Kernpfad ist Magic-sicheres Schreiben – Kartengeneration erkennen → den richtigen Schreibbefehl auswählen → verifizieren → bei stillem Fehlschlag zurückfallen.

Nur für autorisierte Nutzung. Verwenden Sie nur Karten und Systeme, die Ihnen gehören oder für die Sie ausdrücklich die Erlaubnis zum Testen haben. Magic-Karten-Schreibvorgänge und UID-Änderungen haben irreversible Fehlermodi (z. B. Gen3-Freeze).

Voraussetzungen

• Windows + Proxmark3-Iceman-Client (proxmark3.exe) bereits installiert und geflasht

• Python 3.10+

• Serieller Zugriff auf das Gerät (führen Sie nicht gleichzeitig die offizielle Proxmark-GUI auf demselben COM-Port aus)

Related MCP server: mcp-uart

Konfiguration

Kopieren Sie keys.local.json.example → keys.local.json für Standortschlüssel (gitignoriert). Der Server meldet dem LLM nur die Anzahl der Schlüssel, niemals die Schlüsselliste.

Vendor-Bundle-Ordner-Tags (z. B. V9.0.6.7) sind nur Bezeichnungen. Die tatsächliche Client-Version stammt aus pm3_info / proxmark3.exe --version (z. B. Iceman v4.20142). Dieser Server flasht keine Firmware.

Einrichtung

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

Smoke-Test des Clients (keine Karte erforderlich):

& $env:PM3_EXE_PATH --version

Ausführen

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

Cursor / Claude-MCP-Snippet

{
  "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"
      }
    }
  }
}

Bevorzugen Sie den venv-Interpreter, wenn Sie die Abhängigkeiten dort installiert haben:

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

Tool-Oberfläche

Primär (zuerst verwenden)

Erweitert (nur wenn die primären nicht ausreichen): pm3_detect_magic, pm3_try_keys, pm3_read_block, pm3_read_sector, pm3_write_block, pm3_set_uid.

Magic-Schreib-Taxonomie

Gerätebezogene Antworten enthalten _raw (gekürzt) für ein elegantes Parse-Fallback.

Tests

pytest -q

Abgedeckt werden Parser-Fixtures, Access-Bits (FF078069), Write-Router (Gen3 ≠ --gdm) und Client-Validierung (Injection / Whitelist / Batchgröße).

Live-Hardware-Hinweise

• Legen Sie vor pm3_info / Schreibwerkzeugen eine Karte auf die Antenne.

• Keine Karte → ok: false, reason: "no_card" (keine Wiederholungsschleife).

• Gen4 GDM: wrbl auf Trailern kann Erfolg melden, während Daten verschluckt werden — pm3_write_magic_safe verifiziert und fällt zurück.

• Firmware-Flashen ist nicht Teil des Umfangs.

Lizenz

MIT