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 を参照してください。