anonsec-mcp-server

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

Обзор

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

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

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

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

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

Обработка OTP

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

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

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

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

Отправка электронной почты

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

• Поддержка обычного текста и 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 для данных в состоянии покоя

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

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

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

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

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

Архитектура

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

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

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

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

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

Вклад

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

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

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

Лицензия

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