Skip to main content
Glama

⚡ AgentBox

AIエージェントのための自律型主権メールボックス&アイデンティティレイヤー

CI npm version npm downloads GitHub Release Rust MCP License: MIT

AgentBoxは、自律型AIコーディングエージェント(Claude CodeCursorAntigravityOpenAI Swarm)に、永続的なマシンネイティブのメールアイデンティティ、オブジェクトレベルの認可、そして主権的な通信インフラを提供します。メールの受信、0.14ms未満での2FA認証コードの捕捉、アンチフィッシング保護付きのアクティベーションマジックリンク検証、そしてサードパーティクラウドへのロックインゼロでのアウトバウンド返信の送信を実現します。

クイックスタートエージェントアイデンティティ&セキュリティベンチマークMCPツールリンク安全性アーキテクチャ


💡 なぜAgentBoxなのか?

自律型AIエージェントがソフトウェアを構築したり、開発者プラットフォームにアカウント登録したり、自動化されたQAパイプラインを実行したりするとき、彼らは必然的にメール検証、2FA、アイデンティティゲートに直面します。

従来のアプローチの問題

AgentBoxによる主権的ソリューション

❌ 従量課金のSaaSメールAPIはメールごとに課金され、クレジットカードが必要

100%無料&セルフホスト ローカルSQLite(agentbox.db)上で動作

❌ Webhookサービスは公開URL / トンネリング(Ngrok)が必要

内蔵IMAP TLSポーラー&生インバウンドSMTPサーバー(Hostinger、Titan、Google、Stalwart)

❌ REST APIのポーリングはレート制限のボトルネックにより5〜30秒かかる

イベント駆動型非同期ウェイクアップ(<0.001ms) Tokioブロードキャストチャネル経由

❌ 認証されていないツールによるエージェント間のデータ漏洩

必須のスコープ付きケイパビリティ&オブジェクトレベルリソース所有権

❌ エージェントはセキュリティに欠け、フィッシング / オープンリダイレクトリンクに騙される

ディープURL安全性エンジン(Punycode、生IP、オープンリダイレクト防御)

❌ IDE設定での複雑なJSON編集を必要とする手動MCPセットアップ

npx agentbox-mail init 1クリックでClaude Code、Cursor、Antigravityを自動設定


Related MCP server: Mailgent MCP Server

🧑🚀 ファーストクラスのエージェントアイデンティティ&オブジェクトレベルセキュリティ

AgentBoxは、厳格なオブジェクトレベルリソース所有権を備えたファーストクラスのエージェントアイデンティティを導入することで、一般的なメールボックスを超えます:

# Provision a scoped identity for an autonomous browser QA agent
npx agentbox-mail agent create browser-qa --capabilities "inbox.read,otp.read,links.read"
╔══════════════════════════════════════════════════════════════════╗
║             🧑‍🚀 AGENT IDENTITY PROVISIONED                      ║
╠══════════════════════════════════════════════════════════════════╣
║  Agent ID     : agent_browser-qa_7f92a1                          ║
║  Name         : browser-qa                                       ║
║  Email        : browser-qa-7f92a1@apocalypto.in                  ║
║  Auth Token   : agb_92d7e8f1c3a04b12                             ║
║  Capabilities : ["inbox.read", "otp.read", "links.read"]         ║
║  Status       : active                                           ║
╚══════════════════════════════════════════════════════════════════╝
⚠️  NOTE: Store this auth_token securely. It is only displayed once upon creation and cannot be retrieved again.

🔐 多層セキュリティの適用:

                Incoming Tool / API Request
                            │
                            ▼
              ┌───────────────────────────┐
              │ 1. Validate Auth Token    │ ➔ Reject if invalid or revoked
              └─────────────┬─────────────┘
                            │
                            ▼
              ┌───────────────────────────┐
              │ 2. Check Capability Scope │ ➔ E.g. Require "otp.read"
              └─────────────┬─────────────┘
                            │
                            ▼
              ┌───────────────────────────┐
              │ 3. Object-Level Ownership │ ➔ Agent A CANNOT read Agent B's mailbox
              └─────────────┬─────────────┘
                            │
                            ▼
              ┌───────────────────────────┐
              │ 4. Execute Protected Tool │
              └───────────────────────────┘
  • クレデンシャル衛生:トークンは作成時に一度だけ表示されます。読み取りエンドポイント(get_agent_identitylist_agent_identities)は、認証シークレットを決して漏洩しない安全な公開構造体を使用します。

  • エージェント間分離otp.readを持つエージェントは、自分が所有するメールボックス(owner_agent_id)に厳密に制限されます。メールボックスをまたいだアクセスを試みると、構造化されたAccessDeniedエラーが返されます。


📊 再現可能なパフォーマンスベンチマーク

AgentBoxには、生バイトから完全なJSON-RPC出力までのパイプライン全体を測定する完全なベンチマークテストスイート(tests/benchmark.rs)が含まれています:

cargo test --release --test benchmark -- --nocapture

⚡ 検証済みフルエンドツーエンドMCPパイプライン(1,000サイクル):

テスト対象パイプライン: Raw MIME Ingestion ➔ mail-parser ➔ SafeLink Analysis ➔ Regex OTP ➔ SQLite INSERT ➔ Broadcast Dispatch ➔ Authenticated MCP Tool Call (tools/call) ➔ JSON-RPC Result Output

パイプラインメトリクス

測定レイテンシ

スループット

平均(Mean)

681.3 µs(0.681 ms)

毎秒1,468の完全なMCPサイクル

p50中央値

590.0 µs(0.590 ms)

p95

1.20 ms

p99

1.58 ms

⚡ サブコンポーネントのマイクロ秒レイテンシ(10,000回の反復):

  • イベントバスチャネルディスパッチ0.216 µs(0.0002 ms)— 毎秒462万イベント

  • リンク安全性&アンチリダイレクト0.652 µs(0.0007 ms)— 毎秒153万チェック

  • OTP正規表現抽出138.2 µs(0.138 ms)— 毎秒7,230回の抽出

注:外部メールの到着レイテンシは上流のメール配信に依存します。バイトがAgentBox(SMTP/IMAP/HTTP)に到達すると、エンドツーエンドの解析、DB永続化、ケイパビリティ認可、JSON-RPCレスポンスが0.7ms未満で完了します。


🛡️ リンク安全性&アンチフィッシングエンジン

自律型エージェントをクレデンシャル収集や悪意のあるオープンリダイレクトから保護するため、AgentBoxはすべてのインバウンドリンクをディープセーフティアナライザーで解析します:

  • 🚫 オープンリダイレクト検出?redirect=?url=?next=?dest=?to= などのパラメータを検査します。

  • 🚫 生IPアドレス防御:評判の良いホスト名ではなく生のIPv4アドレスを対象とするURLをブロックします。

  • 🚫 Punycodeホモグラフ防御:Unicode/Punycodeドメインのなりすまし(xn--)をフラグします。

  • 🔒 プロトコル検証:安全なHTTPSエンドポイントと安全でないHTTPを区別します。

{
  "url": "https://signin.aws.amazon.com/verify?token=abc_123",
  "domain": "signin.aws.amazon.com",
  "is_safe": true,
  "has_open_redirect": false,
  "confidence": 0.98
}

🛠️ MCPツールリファレンス

AgentBoxは、stdio上で**Model Context Protocol(MCP)**仕様を実装しています:

カテゴリ

ツール

パラメータ

説明

アイデンティティ

create_agent_identity

name, capabilities?

永続的なアイデンティティを作成し、一回限りの秘密認証トークンを返します。

アイデンティティ

get_agent_identity

agent_id

公開エージェントのケイパビリティ、ステータス、メタデータを取得します(トークンはサニタイズ済み)。

アイデンティティ

list_agent_identities

登録されているすべての公開エージェントアイデンティティを一覧表示します。

アイデンティティ

revoke_agent_identity

agent_id

エージェントアイデンティティを失効させ、その認証トークンを即座に無効化します。

メールボックス

create_agent_inbox

name, address?, agent_token?

呼び出し元のエージェントアイデンティティにリンクされた新しい仮想メールボックスを作成します。

メールボックス

get_latest_otp

account_id, agent_token?

所有権検証付きで最新の4〜8桁の認証コードを抽出します。

メールボックス

wait_for_email

account_id, timeout_secs?, agent_token?

イベント駆動型フック:非同期Tokioブロードキャストチャネルがエージェントを0.001ms未満でウェイクアップします。

メールボックス

get_verification_link

account_id, agent_token?

リンク安全性&アンチリダイレクト分析付きの解析済みアクティベーションリンクを返します。

メールボックス

read_agent_inbox

account_id, limit?, agent_token?

最近のメッセージ、本文テキスト全体、HTML、送信者メタデータを取得します。

メールボックス

send_agent_email

account_id, to, subject, body, agent_token?

ケイパビリティチェック付きでSMTPリレー経由のアウトバウンドメールを送信します。

メールボックス

delete_agent_inbox

account_id, agent_token?

一時メールボックスを削除し、保存されたメッセージを消去します。


🚀 クイックスタート

1. ヘッドレスNPM CLI(ゼロセットアップ)

1秒でAIツールを即座に自動設定:

# 1-Click Auto-Install MCP Server & AI Skill into Claude Code, Cursor, Antigravity
npx agentbox-mail init

# Start MCP stdio server
npx agentbox-mail mcp

# Create an Agent Identity with scoped capabilities
npx agentbox-mail agent create coder --capabilities "inbox.read,otp.read,links.read"

# Retrieve latest OTP code
npx agentbox-mail otp agent@yourdomain.com

# Launch Web Dashboard
npx agentbox-mail ui

2. ネイティブElectronデスクトップアプリ

システムトレイとOS通知を備えた完全なスタンドアロンデスクトップ体験のために:

# Clone the repository
git clone https://github.com/RABNEER/AgentBox.git
cd AgentBox

# Install dependencies and start Desktop App
npm install
npm run app

3. 高速Rustコアデーモン

# Build the optimized production binary
cargo build --release

# Start all-in-one daemon (HTTP Port 3000 + SMTP Port 2525)
./target/release/agentbox-mail server --port 3000

🏗️ アーキテクチャ

                                  ┌───────────────────────────┐
                                  │   Incoming Mail Sources   │
                                  └─────────────┬─────────────┘
                                                │
                 ┌──────────────────────────────┼──────────────────────────────┐
                 │                              │                              │
                 ▼                              ▼                              ▼
     ┌───────────────────────┐      ┌───────────────────────┐      ┌───────────────────────┐
     │ Hostinger / Titan /   │      │ Raw SMTP Listener     │      │ Inbound HTTP Webhook  │
     │ Google IMAP TLS (993) │      │ (0.0.0.0:2525)        │      │ (POST /v1/inbound)    │
     └───────────┬───────────┘      └───────────┬───────────┘      └───────────┬───────────┘
                 │                              │                              │
                 └──────────────────────────────┼──────────────────────────────┘
                                                │
                                                ▼
                                 ┌─────────────────────────────┐
                                 │   High-Speed Regex Parser   │
                                 │  • 4–8 Digit OTP Isolator   │
                                 │  • Link Safety Engine       │
                                 └──────────────┬──────────────┘
                                                │
                                                ▼
                                 ┌─────────────────────────────┐
                                 │ Embedded SQLite Storage     │
                                 │       (`agentbox.db`)       │
                                 │  • Accounts  • Identities   │
                                 │  • Messages  • Capabilities │
                                 │  • Resource Ownership Graph │
                                 └──────────────┬──────────────┘
                                                │
                 ┌──────────────────────────────┼──────────────────────────────┐
                 │                              │                              │
                 ▼                              ▼                              ▼
     ┌───────────────────────┐      ┌───────────────────────┐      ┌───────────────────────┐
     │ Realtime SSE Bus      │      │ MCP Server (stdio)    │      │ Native Desktop App /  │
     │ (`GET /v1/events`)    │      │ Scoped Capabilities   │      │ Web Dashboard (:3000) │
     │                       │      │ Object-Level Auth     │      │                       │
     └───────────────────────┘      └───────────────────────┘      └───────────────────────┘

📄 ライセンス

MITライセンスの下で配布されています。詳細はLICENSEを参照してください。

🖤を込めて RABNEER と AgentBox オープンソースコミュニティによって制作されました

A
license - permissive license
-
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    C
    maintenance
    Disposable email MCP server for autonomous AI agents. Create labeled temporary inboxes, wait for verification emails, extract OTP codes and confirmation links — zero human intervention required.
    6
    MIT
  • A
    license
    -
    quality
    F
    maintenance
    Provides identity infrastructure for AI agents to manage email communications, including sending, replying, and organizing messages. It also includes a secure vault for managing credentials and generating TOTP codes.
    22
    MIT
  • A
    license
    -
    quality
    B
    maintenance
    An MCP server that provides AI agents with a persistent, agent-native email mailbox for sending, receiving, and managing emails through bounded-context retrieval, idempotent operations, and explicit acknowledgement.
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Provides disposable email inboxes for AI agents to automatically receive and extract OTPs and magic links, enabling seamless email verification during autonomous workflows.
    3
    96
    MIT

View all related MCP servers

Related MCP Connectors

  • Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.

  • Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.

  • Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/RABNEER/AgentBox'

If you have feedback or need assistance with the MCP directory API, please join our Discord server