anonsec-mcp-server

// für die Sicherheits-Community erstellt — Finanzierung hält es am Laufen

Übersicht

Firefox Relay MCP Server (anonsec-mcp-server) ist ein produktionsreifer Model Context Protocol Server, der umfassende Funktionen zur anonymen E-Mail-Verwaltung über Firefox Relay-Adressen bietet. Mit Datenschutz, Sicherheit und operativer Exzellenz als Kernprinzipien ermöglicht dieser Server KI-Agenten und Anwendungen, E-Mails zu senden, zu empfangen und zu verarbeiten, während vollständige Anonymität gewahrt bleibt.

Related MCP server: agent-inbox

Kernnutzen

• 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 ruhende Daten.

• Produktionsreif: Entwickelt mit Goldstandard-Programmierpraktiken 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 genau 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-Handhabung

• 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 bietet 6 MCP-Tools:

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 von Firefox-Relay-Adressen

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

• urn:anonsec:otp/emails - OTP-E-Mail-Sammlung

• 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 ruhende Daten

• Unveränderliche Audit-Protokolle für alle Vorgänge

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

• Sicherheitsvalidierung für sensible Vorgänge

• 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 - Einzelne Tool-Implementierungen

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

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.