Skip to main content
Glama
deenesjakoruzh
RABNEER

AgentBox

by RABNEER
OverviewSchemaRelated ServersScoreDiscussions
Rust
Hybrid

⚡ AgentBox

AI 에이전트를 위한 독립적 자율 사서함 및 아이덴티티 레이어

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

AgentBox는 자율 AI 코딩 에이전트(Claude Code, Cursor, Antigravity, OpenAI Swarm)에게 영구적인 기계-네이티브 이메일 아이덴티티, 객체 수준 권한 부여, 독립적인 커뮤니케이션 인프라를 제공합니다. 이메일 수신, 0.14ms 미만의 2FA 인증 코드 캡처, 피싱 방지 기능이 포함된 활성화 매직 링크 검증, 그리고 제3자 클라우드 종속 제로로 아웃바운드 회신 전송을 지원합니다.

빠른 시작 • 에이전트 아이덴티티 및 보안 • 벤치마크 • MCP 도구 • 링크 안전 • 아키텍처

💡 왜 AgentBox인가?

자율 AI 에이전트가 소프트웨어를 빌드하거나, 개발자 플랫폼에 계정을 등록하거나, 자동화된 QA 파이프라인을 실행할 때 이메일 검증, 2FA, 아이덴티티 게이트를 피할 수 없습니다.

기존 접근 방식의 문제점

AgentBox 독립적 솔루션

❌ 유료 SaaS 이메일 API는 이메일당 요금을 부과하고 신용카드가 필요함

✅ 로컬 SQLite(agentbox.db) 기반 100% 무료 및 자체 호스팅

❌ 웹훅 서비스는 공개 URL/터널링(Ngrok)이 필요함

✅ 내장형 IMAP TLS 폴러 및 원시 인바운드 SMTP 서버 (Hostinger, Titan, Google, Stalwart)

❌ REST API 폴링은 5–30초가 걸리고 속도 제한 병목 현상 발생

✅ Tokio 브로드캐스트 채널을 통한 이벤트 기반 비동기 웨이크업(<0.001ms)

❌ 인증되지 않은 도구로 인한 에이전트 간 데이터 유출

✅ 필수 범위 지정 권한 및 객체 수준 리소스 소유권

❌ 에이전트는 보안이 부족하여 피싱/오픈 리다이렉트 링크에 속음

✅ 심층 URL 안전 엔진 (Punycode, 원시 IP 및 오픈 리다이렉트 방어)

❌ IDE 설정에서 복잡한 JSON 편집이 필요한 수동 MCP 설정

✅ npx agentbox-mail init 원클릭으로 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_identity, list_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

파이프라인 지표

측정된 지연 시간

처리량

평균

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 호모그래프 방어: 유니코드/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 오픈 소스 커뮤니티가 🖤로 제작

This server cannot be installed

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

How are these scores calculated?

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

  • UnCorreoTemporal

    francofuji
    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

  • Mailgent MCP Server

    loomal-ai
    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

  • Shoot Email

    powersurge01
    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

  • zerodrop-mcp

    zerodrop-dev
    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

  • CryptoAgentMail

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

  • e2a — email for AI agents

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

  • e2a — email for AI agents

    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