PiQrypt MCP-Server

Kryptografischer Audit-Trail für KI-Agenten via Model Context Protocol

Related MCP server: DCL Evaluator

🚀 Was ist PiQrypt MCP?

Der PiQrypt MCP-Server bietet Zugriff via Model Context Protocol auf PiQrypt — den post-quantenkryptografischen Audit-Trail für KI-Agenten.

Anwendungsfälle:

• 🤖 KI-Agenten: Jede Entscheidung mit einem kryptografischen Nachweis signieren

• 📊 n8n-Workflows: Audit-Trail zu Automatisierungs-Workflows hinzufügen

• 🏦 Trading-Bots: SEC/FINRA-Compliance für automatisierten Handel

• 👥 HR-Automatisierung: DSGVO-konforme KI-Einstellungsentscheidungen

• 🏥 KI im Gesundheitswesen: HIPAA-Audit-Trail für medizinische Entscheidungen

📦 Installation

Voraussetzungen

1. PiQrypt installieren (erforderlich — Python 3.8+)

pip install piqrypt

Der MCP-Server delegiert alle kryptografischen Operationen an das Python-Paket piqrypt. Wenn es nicht installiert ist, gibt der Server bei jedem Tool-Aufruf einen klaren Fehler zurück.

2. Den MCP-Server installieren (Node.js 18+)

npm install -g @piqrypt/mcp-server

Installation via npx (keine globale Installation)

npx @piqrypt/mcp-server

Aus dem Quellcode bauen

git clone https://github.com/piqrypt/piqrypt-mcp-server
cd piqrypt-mcp-server
npm install
npm run build

PIQRYPT_PYTHON — benutzerdefinierte Python-Umgebung

Standardmäßig verwendet der Server python3 (Linux/Mac) oder python (Windows). Wenn piqrypt in einer virtuellen Umgebung installiert ist, setzen Sie diese Variable, um auf den richtigen Interpreter zu verweisen:

Windows

set PIQRYPT_PYTHON=C:\path\to\venv\Scripts\python.exe

Linux / Mac

export PIQRYPT_PYTHON=/path/to/venv/bin/python

Um dies dauerhaft zu machen, fügen Sie es Ihrer MCP-Client-Konfiguration hinzu:

{
  "mcpServers": {
    "piqrypt": {
      "command": "piqrypt-mcp-server",
      "args": [],
      "env": {
        "PIQRYPT_PYTHON": "/path/to/venv/bin/python"
      }
    }
  }
}

⚙️ Konfiguration

Claude Desktop

Hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "piqrypt": {
      "command": "piqrypt-mcp-server",
      "args": []
    }
  }
}

n8n (v1.88+)

1. n8n MCP-Integration installieren

2. PiQrypt MCP-Server zur Konfiguration hinzufügen

3. In Workflows über den MCP-Node verwenden

Kompatibel mit

MCP-Clients

Automatisierungsplattformen (via MCP-Node)

Was Sie mit PiQrypt MCP auditieren können

Jeder Tool-Aufruf durchläuft dieselben 4 Operationen — Stempeln, Verifizieren, Exportieren, Suchen. Hier ist, was das in der Praxis je nach Kontext bedeutet:

Automatisierter Handel / Finanzen Jeder Agent, der Aufträge erteilt, Portfolios umschichtet oder Transaktionen auslöst, kann jede Entscheidung vor der Ausführung stempeln. Die signierte Kette ist für SEC/FINRA- Audits ohne zusätzliche Infrastruktur exportierbar.

HR- und Einstellungsautomatisierung Jeder Workflow, der Kandidaten bewertet, Lebensläufe punktet oder Bewerber weiterleitet, kann jede Entscheidung stempeln. Bietet einen DSGVO Art. 22-konformen Audit-Trail für KI-gestützte Einstellungsprozesse — wer hat was wann entschieden und welche Daten wurden verwendet (gehasht, niemals im Klartext gespeichert).

Content- und Publishing-Pipelines Jeder Agent, der Inhalte entwirft, genehmigt oder veröffentlicht, kann jeden Schritt stempeln. Nützlich, wenn mehrere KI-Agenten zusammenarbeiten und Sie die Zuordnung nachweisen müssen — welcher Agent hat was in welcher Reihenfolge geschrieben.

DevOps und CI/CD Jeder Agent, der Deployments auslöst, Branches zusammenführt oder Geheimnisse rotiert, kann jede Aktion stempeln. Bietet eine fälschungssichere Aufzeichnung von Infrastrukturänderungen, die von autonomen Agenten vorgenommen wurden.

Gesundheitswesen und medizinische KI Jeder Diagnose- oder Triage-Agent kann jede Empfehlung stempeln. Bietet einen HIPAA-konformen Audit-Trail, der jede KI-Ausgabe mit einer verifizierbaren Agentenidentität verknüpft.

Das gemeinsame Muster in allen Fällen:

[Agent makes decision]
↓
piqrypt_stamp_event    ← sign + chain
↓
[Agent executes action]
↓
piqrypt_export_audit   ← portable proof, verifiable
                          without PiQrypt installed

🛠️ Verfügbare Tools

1. piqrypt_stamp_event

Signieren Sie eine KI-Entscheidung mit einem kryptografischen Nachweis.

Parameter:

• agent_id (Zeichenkette, erforderlich): Agenten-Identifikator

• payload (Objekt, erforderlich): Entscheidungsdaten

• previous_hash (Zeichenkette, optional): Hash des vorherigen Ereignisses zur Verkettung

Beispiel:

const event = await mcp.call('piqrypt_stamp_event', {
  agent_id: 'trading_bot_v1',
  payload: {
    action: 'buy',
    symbol: 'AAPL',
    quantity: 100,
    price: 150.25
  }
});

Rückgabe:

{
  "version": "AISS-1.0",
  "agent_id": "trading_bot_v1",
  "timestamp": 1739382400,
  "nonce": "uuid-...",
  "payload": { ... },
  "previous_hash": "sha256:...",
  "signature": "base64:..."
}

2. piqrypt_verify_chain

Überprüfen Sie die Integrität der Ereigniskette.

Parameter:

• events (Array, erforderlich): Zu überprüfende Ereignisse

Beispiel:

const result = await mcp.call('piqrypt_verify_chain', {
  events: [event1, event2, event3]
});

Rückgabe:

{
  "valid": true,
  "events_count": 3,
  "chain_hash": "sha256:...",
  "errors": []
}

3. piqrypt_export_audit

Exportieren Sie den Audit-Trail für Compliance-Zwecke.

Parameter:

• agent_id (Zeichenkette, erforderlich): Zu exportierender Agent

• certified (Boolesch): PiQrypt-Zertifizierung anfordern

• output_format (Zeichenkette): json oder pqz

Beispiel:

const audit = await mcp.call('piqrypt_export_audit', {
  agent_id: 'trading_bot_v1',
  certified: true,
  output_format: 'json'
});

4. piqrypt_search_events

Schnelle Suche über SQLite-Index.

Parameter:

• event_type (Zeichenkette, optional): Nach Typ filtern

• from_timestamp (Zahl, optional): Startzeit

• to_timestamp (Zahl, optional): Endzeit

• limit (Zahl): Maximale Ergebnisse (Standard: 100)

Beispiel:

const trades = await mcp.call('piqrypt_search_events', {
  event_type: 'trade_executed',
  from_timestamp: 1739300000,
  limit: 50
});

📊 Vigil-Dashboard (optional, kostenlos)

Jedes gestempelte Ereignis ist in Vigil sichtbar — PiQrypts lokales Monitoring-Dashboard.

Hinweis: Vigil wird nicht automatisch vom MCP-Server gestartet. Sie müssen es separat starten, bevor Sie das Dashboard öffnen.

piqrypt vigil
# → http://localhost:8421

Der kostenlose Tarif beinhaltet: Kettenintegrität, VRS-Risiko-Score, 7-Tage-Verlauf, KRITISCHE Warnungen. Upgrade auf Pro für 90-Tage- Verlauf, TrustGate-Governance und post-quanten Signaturen.

🗑️ Agenten verwalten

Agenten werden beim ersten Stempeln automatisch erstellt. Um Agenten anzuzeigen und zu löschen:

1. Vigil starten: piqrypt vigil

2. http://localhost:8421 öffnen

3. Zur Ansicht All Agents gehen

4. Die zu löschenden Agenten auswählen → auf ✕ Delete selected klicken

5. Bestätigen — Vigil kehrt zum Willkommensbildschirm zurück, wenn keine Agenten mehr vorhanden sind

Agenten werden auf Ihrem Computer unter ~/.piqrypt/agents/ gespeichert. Das Löschen eines Agenten entfernt dauerhaft seine Schlüssel und seinen Ereignisverlauf.

🔒 Sicherheitsmodell

Prozessisolierung

┌─────────────────────────────────────┐
│  MCP Client (any MCP-compatible client)     │
│  ↓ JSON-RPC over stdio              │
├─────────────────────────────────────┤
│  MCP Server (TypeScript/Node.js)    │  ← No crypto here
│  ↓ subprocess call                  │
├─────────────────────────────────────┤
│  Python Bridge (bridge.py)          │
│  ↓ invokes CLI                      │
├─────────────────────────────────────┤
│  PiQrypt CLI (Python)               │
│  ↓ uses                             │
├─────────────────────────────────────┤
│  Core Crypto (aiss package)         │  ← All crypto here
│  • Ed25519 / Dilithium3             │
│  • RFC 8785 canonical JSON          │
│  • Hash chains                      │
└─────────────────────────────────────┘

Garantien

✅ Private Schlüssel niemals gegenüber der MCP-Ebene offengelegt ✅ Alle Kryptografie in Python (Ed25519, Dilithium3) ✅ Gleiche Sicherheit wie CLI (Prozessisolierung) ✅ RFC AISS-1.1 konform (identische Ausgabe) ✅ Eingabevalidierung vor dem Subprozess-Aufruf

📚 Beispiele

Trading-Bot (n8n)

[Webhook: price alert] 
    ↓
[AI Decision: buy/sell?]
    ↓
[PiQrypt MCP: stamp decision]  ← Audit trail
    ↓
[Execute trade API]
    ↓
[Database: store proof]

HR-Automatisierung

[Upload CV]
    ↓
[AI Agent: evaluate candidate]
    ↓
[PiQrypt MCP: stamp evaluation]  ← GDPR compliance
    ↓
[Email HR team]

🧪 Testen

# Build
npm run build

# Test bridge
python3 src/python/bridge.py stamp '{"agent_id":"test","payload":{"action":"test"}}'

# Test MCP server (manual)
node dist/index.js
# Then send MCP request via stdin

🔧 Fehlerbehebung

Error: piqrypt is not installed in this Python environment

Der vom MCP-Server verwendete Python-Interpreter kann das piqrypt-Paket nicht finden.

Lösung:

pip install piqrypt

Wenn piqrypt in einer virtuellen Umgebung und nicht im System-Python installiert ist, setzen Sie PIQRYPT_PYTHON auf den korrekten Interpreter:

# Linux / Mac
export PIQRYPT_PYTHON=/path/to/venv/bin/python

# Windows
set PIQRYPT_PYTHON=C:\path\to\venv\Scripts\python.exe

Um zu überprüfen, welches Python der Server verwenden wird:

# Linux / Mac
$PIQRYPT_PYTHON -c "import aiss; print('ok')"

# Windows
%PIQRYPT_PYTHON% -c "import aiss; print('ok')"

📖 Dokumentation

• MCP-Einrichtungsanleitung

• Tool-Referenz

• n8n-Integration

• Sicherheitsmodell

• RFC-Konformität

🤝 Mitwirken

Wir freuen uns über Beiträge! Siehe CONTRIBUTING.md.

📄 Lizenz

MCP-Server → MIT-Lizenz - siehe LICENSE PiQrypt Core → kostenloser Tarif + kommerzielle Tarife

🔗 Links

• PiQrypt Core: https://github.com/piqrypt/piqrypt

• MCP-Protokoll: https://modelcontextprotocol.io

• n8n: https://n8n.io

• Dokumentation: https://docs.piqrypt.com

Mit ❤️ gebaut von PiQrypt Inc.