anonsec-mcp-server

// creado para la comunidad de seguridad — la financiación lo mantiene

Resumen

Firefox Relay MCP Server (anonsec-mcp-server) es un servidor de Model Context Protocol de nivel de producción que proporciona capacidades integrales de gestión de correo electrónico anónimo a través de direcciones de Firefox Relay. Construido con la privacidad, la seguridad y la excelencia operativa como principios fundamentales, este servidor permite a los agentes y aplicaciones de IA enviar, recibir y procesar correos electrónicos manteniendo un anonimato completo.

Related MCP server: agent-inbox

Propuesta de valor principal

• Privacidad primero: Todas las operaciones de correo mantienen el anonimato del remitente a través de la infraestructura de Firefox Relay.

• Listo para PQC: Arquitectura de cifrado lista para criptografía post-cuántica para datos en reposo.

• Grado de producción: Construido con prácticas de programación de estándar de oro para fiabilidad y seguridad.

• Nativo de MCP: Cumplimiento total con el Model Context Protocol 2.0 con herramientas y recursos.

Inicio rápido

Requisitos previos

• Node.js >= 18.0.0

• npm o yarn

• Cuenta de Firefox Relay y acceso a la API

Instalación

# 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

Configuración

Crea un archivo .env con tus credenciales de Firefox Relay:

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

La clave de cifrado debe tener exactamente 32 bytes (64 caracteres hexadecimales). Genera una con:

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

Capacidades

Gestión de correo electrónico

• Listar correos electrónicos nuevos/no leídos de direcciones de Firefox Relay

• Leer el contenido completo del correo con descifrado

• Recuperar todos los correos con filtrado

• Obtener el último correo de cualquier dirección de relay

Manejo de OTP

• Extraer códigos OTP de los correos

• Validar el formato y la confianza del OTP

• Comprobar la expiración del OTP

• Re-extraer OTP del cuerpo del correo

Envío de correo electrónico

• Enviar correos electrónicos anónimos a través de direcciones de relay

• Soporte para contenido de texto plano y HTML

• Encabezados y metadatos personalizados

• Simulación de correo OTP

Estructura del proyecto

.
├── 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

Herramientas

El servidor proporciona 6 herramientas MCP:

1. new_emails - Recuperar correos nuevos/no leídos

2. read_emails - Leer el contenido completo del correo

3. all_emails - Listar todos los correos con filtrado

4. latest_email - Obtener el último correo

5. latest_email_otp - Extraer OTP del último correo

6. send_anon_email - Enviar correos electrónicos anónimos

Recursos

• urn:anonsec:relay/addresses - Gestión de direcciones de Firefox Relay

• urn:anonsec:email/collection - Acceso a la colección de correos

• urn:anonsec:otp/emails - Colección de correos OTP

• urn:anonsec:server/info - Información del servidor

• urn:anonsec:audit/logs - Registros de auditoría

• urn:anonsec:email/{emailId} - Acceso a correo individual

Características de seguridad

• Cifrado AES-256-GCM para datos en reposo

• Registros de auditoría inmutables para todas las operaciones

• Seguimiento de ID de solicitud para trazabilidad

• Validación de seguridad para operaciones sensibles

• Enmascaramiento de códigos OTP en las respuestas (nunca expuestos)

• Redacción de datos sensibles en los registros de auditoría

Arquitectura

El servidor sigue una arquitectura limpia y lista para producción:

1. Capa de servidor MCP - Inicialización del servidor, registro de herramientas, manejo de solicitudes

2. Capa de herramientas - Implementaciones de herramientas individuales

3. Capa de servicios principales - Base de datos, cliente API, configuración, tipos, utilidades

4. Capa de datos - Base de datos SQLite con cifrado listo para PQC

Contribuciones

¡Las contribuciones son bienvenidas! Consulta CONTRIBUTING.md para obtener pautas.

Seguridad

Consulta SECURITY.md para informar vulnerabilidades y conocer las prácticas de seguridad.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta LICENSE para más detalles.