anonsec-mcp-server

// создано для сообщества специалистов по безопасности — финансирование поддерживает проект

Обзор

Firefox Relay MCP Server (anonsec-mcp-server) — это сервер Model Context Protocol производственного уровня, который предоставляет комплексные возможности управления анонимной электронной почтой через адреса Firefox Relay. Построенный на принципах конфиденциальности, безопасности и операционного совершенства, этот сервер позволяет AI-агентам и приложениям отправлять, получать и обрабатывать электронные письма, сохраняя полную анонимность.

Related MCP server: agent-inbox

Основное ценностное предложение

• Конфиденциальность прежде всего: все операции с электронной почтой сохраняют анонимность отправителя через инфраструктуру Firefox Relay

• Готовность к PQC: архитектура шифрования, готовая к постквантовой криптографии, для данных в состоянии покоя

• Производственный уровень: создан с использованием эталонных практик программирования для надёжности и безопасности

• Нативный MCP: полное соответствие Model Context Protocol 2.0 с инструментами и ресурсами

Быстрый старт

Предварительные требования

• Node.js >= 18.0.0

• npm или yarn

• Учётная запись Firefox Relay и доступ к API

Установка

# 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

Конфигурация

Создайте файл .env с вашими учётными данными 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

Ключ шифрования должен быть ровно 32 байта (64 шестнадцатеричных символа). Сгенерируйте его с помощью:

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

Возможности

Управление электронной почтой

• Список новых/непрочитанных писем с адресов Firefox Relay

• Чтение полного содержимого писем с расшифровкой

• Получение всех писем с фильтрацией

• Получение последнего письма с любого адреса relay

Обработка OTP

• Извлечение OTP-кодов из писем

• Проверка формата OTP и уверенности

• Проверка срока действия OTP

• Повторное извлечение OTP из тела письма

Отправка писем

• Отправка анонимных писем через адреса relay

• Поддержка обычного текста и HTML-содержимого

• Пользовательские заголовки и метаданные

• Симуляция OTP-писем

Структура проекта

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

Инструменты

Сервер предоставляет 6 MCP-инструментов:

1. new_emails — получение новых/непрочитанных писем

2. read_emails — чтение полного содержимого писем

3. all_emails — список всех писем с фильтрацией

4. latest_email — получение последнего письма

5. latest_email_otp — извлечение OTP из последнего письма

6. send_anon_email — отправка анонимных писем

Ресурсы

• urn:anonsec:relay/addresses — управление адресами Firefox Relay

• urn:anonsec:email/collection — доступ к коллекции писем

• urn:anonsec:otp/emails — коллекция OTP-писем

• urn:anonsec:server/info — информация о сервере

• urn:anonsec:audit/logs — журналы аудита

• urn:anonsec:email/{emailId} — доступ к отдельному письму

Функции безопасности

• Шифрование AES-256-GCM для данных в состоянии покоя

• Неизменяемые журналы аудита для всех операций

• Отслеживание ID запросов для трассируемости

• Проверка безопасности для чувствительных операций

• Маскирование OTP-кодов в ответах (никогда не раскрываются)

• Редактирование чувствительных данных в журналах аудита

Архитектура

Сервер следует чистой, готовой к продакшену архитектуре:

1. Слой MCP-сервера — инициализация сервера, регистрация инструментов, обработка запросов

2. Слой инструментов — отдельные реализации инструментов

3. Слой основных сервисов — база данных, API-клиент, конфигурация, типы, утилиты

4. Слой данных — база данных SQLite с шифрованием, готовым к PQC

Вклад

Вклад приветствуется! См. CONTRIBUTING.md для получения рекомендаций.

Безопасность

См. SECURITY.md для сообщения об уязвимостях и практик безопасности.

Лицензия

Этот проект лицензирован под лицензией MIT — см. LICENSE для подробностей.