anonsec-mcp-server

// für die Sicherheits-Community entwickelt – Spenden halten die Wartung aufrecht

Überblick

Firefox Relay MCP Server (anonsec-mcp-server) ist ein produktionsreifer Model-Context-Protocol-Server, der umfassende Funktionen für anonymes E-Mail-Management über Firefox-Relay-Adressen bereitstellt. Entwickelt mit Datenschutz, Sicherheit und operativer Exzellenz als Kernprinzipien, ermöglicht dieser Server KI-Agenten und Anwendungen das Senden, Empfangen und Verarbeiten von E-Mails bei vollständiger Anonymität.

Related MCP server: agent-inbox

Zentrales Wertversprechen

• Datenschutz zuerst: Alle E-Mail-Operationen wahren die Anonymität des Absenders über die Firefox-Relay-Infrastruktur

• PQC-bereit: Post-Quantum-Kryptografie-bereite Verschlüsselungsarchitektur für Daten im Ruhezustand

• Produktionsreif: Entwickelt mit Best-Practice-Programmierstandards für Zuverlässigkeit und Sicherheit

• MCP-nativ: Volle Konformität mit Model Context Protocol 2.0 inklusive Tools und Ressourcen

Schnellstart

Voraussetzungen

• Node.js >= 18.0.0

• npm oder yarn

• Firefox-Relay-Konto und API-Zugriff

Installation

# Clone the repository
git clone https://github.com/VRIL-LABS/anonsec-mcp-server.git
cd anonsec-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm run dev

Konfiguration

Erstellen Sie eine .env-Datei mit Ihren Firefox-Relay-Zugangsdaten:

FIREFOX_RELAY_API_KEY=your_api_key_here
ENCRYPTION_KEY=your_32_byte_hex_key_here
DATABASE_PATH=./data/anonsec.sqlite
PORT=3000

Der Verschlüsselungsschlüssel muss exakt 32 Bytes (64 Hexadezimalzeichen) lang sein. Generieren Sie einen mit:

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

Funktionen

E-Mail-Verwaltung

• Neue/ungelesene E-Mails von Firefox-Relay-Adressen auflisten

• Vollständigen E-Mail-Inhalt mit Entschlüsselung lesen

• Alle E-Mails mit Filtern abrufen

• Neueste E-Mail von jeder Relay-Adresse abrufen

OTP-Verarbeitung

• OTP-Codes aus E-Mails extrahieren

• OTP-Format und Konfidenz validieren

• OTP-Ablauf prüfen

• OTP erneut aus dem E-Mail-Text extrahieren

E-Mail-Versand

• Anonyme E-Mails über Relay-Adressen senden

• Unterstützung für Klartext- und HTML-Inhalte

• Benutzerdefinierte Header und Metadaten

• OTP-E-Mail-Simulation

Projektstruktur

.
├── src/
│   ├── index.ts          # Server entry point and configuration
│   ├── api/
│   │   └── index.ts      # Firefox Relay API client
│   ├── config/
│   │   └── index.ts      # Configuration management
│   ├── db/
│   │   └── index.ts      # SQLite database service
│   ├── tools/
│   │   ├── all_emails.ts
│   │   ├── latest_email.ts
│   │   ├── latest_email_otp.ts
│   │   ├── new_emails.ts
│   │   ├── read_emails.ts
│   │   └── send_anon_email.ts
│   ├── types/
│   │   └── index.ts      # Type definitions
│   └── utils/
│       ├── crypto.ts     # Encryption utilities
│       └── otp.ts        # OTP extraction utilities
├── package.json
├── tsconfig.json
├── LICENSE
└── README.md

Tools

Der Server stellt 6 MCP-Tools bereit:

1. new_emails – Neue/ungelesene E-Mails abrufen

2. read_emails – Vollständigen E-Mail-Inhalt lesen

3. all_emails – Alle E-Mails mit Filtern auflisten

4. latest_email – Die neueste E-Mail abrufen

5. latest_email_otp – OTP aus der neuesten E-Mail extrahieren

6. send_anon_email – Anonyme E-Mails senden

Ressourcen

• urn:anonsec:relay/addresses – Verwaltung der Firefox-Relay-Adressen

• urn:anonsec:email/collection – Zugriff auf die E-Mail-Sammlung

• urn:anonsec:otp/emails – Sammlung von OTP-E-Mails

• urn:anonsec:server/info – Serverinformationen

• urn:anonsec:audit/logs – Audit-Protokolle

• urn:anonsec:email/{emailId} – Zugriff auf einzelne E-Mails

Sicherheitsfunktionen

• AES-256-GCM-Verschlüsselung für Daten im Ruhezustand

• Unveränderliche Audit-Protokolle für alle Operationen

• Anfrage-ID-Verfolgung für Rückverfolgbarkeit

• Sicherheitsvalidierung für sensible Operationen

• OTP-Code-Maskierung in Antworten (niemals offengelegt)

• Schwärzung sensibler Daten in Audit-Protokollen

Architektur

Der Server folgt einer sauberen, produktionsreifen Architektur:

1. MCP-Server-Ebene – Serverinitialisierung, Tool-Registrierung, Anfrageverarbeitung

2. Tools-Ebene – Implementierung einzelner Tools

3. Kern-Services-Ebene – Datenbank, API-Client, Konfiguration, Typen, Hilfsfunktionen

4. Datenebene – SQLite-Datenbank mit PQC-bereiter Verschlüsselung

Mitwirken

Beiträge sind willkommen! Siehe CONTRIBUTING.md für Richtlinien.

Sicherheit

Siehe SECURITY.md für die Meldung von Schwachstellen und Sicherheitspraktiken.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe LICENSE für Details.