anonsec-mcp-server

// セキュリティコミュニティのために制作 — 資金提供により維持されています

概要

Firefox Relay MCP Server (anonsec-mcp-server) は、Firefox Relay アドレスを通じて包括的な匿名メール管理機能を提供する、本番グレードの Model Context Protocol サーバーです。プライバシー、セキュリティ、運用の卓越性を中核原則として構築されており、このサーバーにより AI エージェントやアプリケーションは完全な匿名性を維持しながらメールの送信、受信、処理を行うことができます。

Related MCP server: agent-inbox

中核的価値提案

• プライバシー最優先: すべてのメール操作は Firefox Relay インフラを通じて送信者の匿名性を維持します

• PQC 対応: 保存データのための耐量子計算暗号（Post-Quantum Cryptography）対応の暗号化アーキテクチャ

• 本番グレード: 信頼性とセキュリティのための黄金標準のプログラミング慣行で構築

• 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

設定

Firefox Relay の認証情報を記載した .env ファイルを作成します:

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 桁の 16 進文字）である必要があります。次のコマンドで生成します:

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 暗号化

• すべての操作に対する不変の監査ログ

• トレーサビリティのためのリクエスト ID 追跡

• 機密操作のためのセキュリティ検証

• レスポンスにおける OTP コードのマスキング（決して公開されません）

• 監査ログにおける機密データの編集

アーキテクチャ

サーバーはクリーンで本番対応のアーキテクチャに従います:

1. MCP サーバーレイヤー - サーバー初期化、ツール登録、リクエスト処理

2. ツールレイヤー - 個々のツール実装

3. コアサービスレイヤー - データベース、API クライアント、設定、型、ユーティリティ

4. データレイヤー - PQC 対応暗号化を備えた SQLite データベース

コントリビューション

コントリビューションを歓迎します！ ガイドラインについては CONTRIBUTING.md を参照してください。

セキュリティ

脆弱性の報告とセキュリティ慣行については SECURITY.md を参照してください。

ライセンス

このプロジェクトは MIT ライセンス の下でライセンスされています - 詳細は LICENSE を参照してください。