de en es ja ko ru zh

AgentBox

Name: AgentBox
Author: RABNEER

by RABNEER

Overview Schema Source Related Servers Discussions Admin

Rust

Hybrid

⚡ AgentBox

Уровень электронной почты и идентичности для ИИ-агентов

AgentBox даёт любому автономному ИИ-агенту (Claude Code, Cursor, Antigravity, OpenAI Swarm) собственную машинно-нативную электронную почту, входящие, исходящие сообщения, аутентификацию и управляемые событиями возможности электронной почты — самостоятельно размещаемый, суверенный и молниеносно быстрый.

Быстрый старт • Основная абстракция • Идентичность и безопасность агента • Варианты использования • Бенчмарки • Справочник MCP-инструментов • Архитектура

💡 Основная проблема

Автономным ИИ-агентам нужен способ взаимодействия с человеческим миром и друг с другом. Сегодня электронная почта — это универсальный протокол связи для всех программ и платформ:

Как браузерный агент подтверждает свою учётную запись на GitHub или AWS? Электронная почта.
Как клиент связывается с вашим ИИ-ассистентом поддержки? Электронная почта.
Как внешний QA-агент передаёт отчёт об ошибке агенту-кодеру? Электронная почта.
Как исследовательский агент получает дайджесты arXiv и отраслевые оповещения? Электронная почта.

Без машинно-нативной почтовой инфраструктуры разработчики вынуждены использовать хрупкий опрос API, взламывать личные почтовые ящики Gmail или вручную нажимать на ссылки подтверждения.

AgentBox решает эту проблему полностью.

                    ┌─────────────────────────┐
                    │        AGENTBOX         │
                    └────────────┬────────────┘
                                 │
              ┌──────────────────┴──────────────────┐
              ▼                                     ▼
        🧑🚀 IDENTITY                         📬 COMMUNICATION
  • User-Defined Name & Email           • Inbound Inbox (SMTP/IMAP/HTTP)
  • Persistent Agent ID                 • Outbound SMTP Relay
  • Scoped Capability Matrix            • Realtime Event Bus (<0.001ms)
  • Object-Level Ownership              • OTP Isolator & SafeLink Engine
              │                                     │
              └──────────────────┬──────────────────┘
                                 │
                                 ▼
                     Autonomous AI Agent

Related MCP server: Mailgent MCP Server

🧑🚀 Идентичность агента и модель безопасности

AgentBox не предписывает, кто ваш агент. Вы определяете имя агента, адрес электронной почты и политику возможностей:

# 1. Create a Support Agent with a custom company email
npx agentbox-mail agent create support \
  --email support@mycompany.com \
  --capabilities "inbox.read,email.send"

# 2. Create an Autonomous Coding Agent
npx agentbox-mail agent create coder \
  --email coder@mycompany.com \
  --capabilities "inbox.read,task.claim,task.update,otp.read"

# 3. Create a Browser QA Agent with standard verification permissions
npx agentbox-mail agent create browser-qa \
  --capabilities "inbox.read,otp.read,links.read"

╔══════════════════════════════════════════════════════════════════╗
║             🧑‍🚀 AGENT IDENTITY PROVISIONED                      ║
╠══════════════════════════════════════════════════════════════════╣
║  Agent ID     : agent_coder_7f92a1                               ║
║  Name         : coder                                            ║
║  Email        : coder@mycompany.com                              ║
║  Auth Token   : agb_92d7e8f1c3a04b12                             ║
║  Capabilities : ["inbox.read", "task.claim", "otp.read"]        ║
║  Status       : active                                           ║
╚══════════════════════════════════════════════════════════════════╝
⚠️  NOTE: Store this auth_token securely. It is only displayed once upon creation.

🔐 Многоуровневое обеспечение безопасности:

Аутентификация по токену: Проверяет идентичность и статус агента (active vs revoked).
Области возможностей: Проверяет необходимые разрешения (inbox.read, email.send, otp.read, task.claim).
Владение почтовым ящиком на уровне объекта: Агент A, обладающий otp.read, строго ограничен своими назначенными почтовыми ящиками (owner_agent_id). Попытка доступа к чужому агенту возвращает явную ошибку AccessDenied.
Гигиена учётных данных: Публичные запросы (get_agent_identity, list_agent_identities) используют санитизированные структуры, которые никогда не раскрывают токены.

🌐 Универсальные варианты использования

AgentBox предоставляет базовый уровень идентичности электронной почты. Вот некоторые из самых мощных рабочих процессов, построенных на его основе:

1. 🤖 Делегирование работы между агентами и протоколы задач

Внешний QA- или исследовательский агент (например, Jules) отправляет электронное письмо с ошибкой или запросом функции. Встроенный TaskDetector AgentBox автоматически анализирует тему ([TASK:BUG]), извлекает репозиторий, ветку, приоритет и цитаты строк, создаёт AgentTask и пробуждает агента-кодера через шину событий:

   Jules (QA Agent)
          │
          │ 1. Sends email: "[TASK:BUG] Fix duplicate property filter in EstateFlow"
          │    Body: "Repository: RABNEER/EstateFlow\nPriority: high\nEvidence: tests/search.spec.ts:87"
          ▼
 ┌─────────────────┐
 │    AgentBox     │ ──► Auto-detects Work Order via `TaskDetector`
 └────────┬────────┘ ──► Provisions `AgentTask` & records audit event
          │
          │ 2. Realtime Event Bus Dispatch (<0.001ms) / SSE Daemon Bridge
          ▼
 Coder (Worker Agent / Claude Code)
          │ 3. Instantaneously claims task via `claim_agent_task`
          │ 4. Fixes code, opens GitHub PR, calls `update_task_progress`
          │ 5. Calls `complete_agent_task` with CI results
          ▼
 ┌─────────────────┐
 │    AgentBox     │ ──► Status: "completed" + Immutable Audit Lineage
 └────────┬────────┘
          │ 6. Emits completion notification to Jules / User
          ▼
   Jules closes ticket

2. 🔐 Автономная регистрация в SaaS и проверка 2FA / OTP

Браузерные агенты (Puppeteer, Playwright, Stagehand) должны регистрироваться в инструментах, подтверждать адреса электронной почты и решать задачи OTP:

Агент создаёт почтовый ящик create_agent_inbox(name: "signup-bot").
Запускает регистрацию на платформе (например, AWS, Stripe, Vercel).
Вызывает get_latest_otp() (извлекается с помощью регулярного выражения за <0.14ms) или get_verification_link() (проверяется с помощью защиты от перенаправлений и фишинга).
Учётная запись подтверждается автономно без участия человека.

3. 💬 Автономная входящая поддержка и сортировка клиентов

Дайте вашему агенту поддержки клиентов собственный адрес электронной почты (support@yourcompany.com):

Клиент отправляет письмо в поддержку с проблемой.
AgentBox принимает письмо через raw SMTP или IMAP-синхронизацию.
Событие Realtime SSE уведомляет агента поддержки.
Агент анализирует запрос, обращается к внутренним документам и отвечает через send_agent_email().

4. 🔬 Исследования и сбор информации

Дайте вашему исследовательскому агенту идентичность (researcher@yourcompany.com):

Подписывается на отраслевые рассылки, уведомления о безопасности (CVE) и дайджесты arXiv.
Агент периодически читает входящие письма с помощью read_agent_inbox().
Синтезирует сводки для руководства, обобщает результаты и пересылает дайджесты вашей команде.

5. 🛡️ Оповещения DevOps и автоматическое реагирование на инциденты

Дайте вашему агенту реагирования на инциденты идентичность (oncall@yourcompany.com):

Получает критические оповещения об ошибках от Datadog, Sentry или PagerDuty.
Хук реального времени немедленно пробуждает агента.
Агент запрашивает журналы, определяет сбойный коммит и отправляет заказ на исправление агенту-кодеру.

📊 Воспроизводимые бенчмарки производительности

AgentBox включает полный набор бенчмарк-тестов (tests/benchmark.rs), измеряющих весь конвейер от необработанных байтов до полного вывода JSON-RPC:

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

⚡ Проверенный полный сквозной конвейер MCP (1000 циклов):

Тестируемый конвейер: Raw MIME Ingestion ➔ mail-parser ➔ SafeLink Analysis ➔ Regex OTP ➔ SQLite INSERT ➔ Broadcast Dispatch ➔ Authenticated MCP Tool Call (tools/call) ➔ JSON-RPC Result Output

Метрика конвейера	Измеренная задержка	Пропускная способность
Среднее (среднее)	`451.9 µs` (0.451 ms)	2,213 полных циклов MCP/сек
p50 Медиана	`431.5 µs` (0.431 ms)	—
p95	`586.2 µs` (0.586 ms)	—
p99	`1.04 ms`	—

⚡ Микросекундные задержки подкомпонентов (10 000 итераций):

Диспетчеризация канала шины событий: 0.216 µs (0.0002 ms) — 4.62 миллиона событий/сек
Безопасность ссылок и защита от перенаправлений: 0.652 µs (0.0007 ms) — 1.53 миллиона проверок/сек
Извлечение OTP с помощью регулярных выражений: 138.2 µs (0.138 ms) — 7,230 извлечений/сек

🛠️ Справочник MCP-инструментов

AgentBox реализует спецификацию Model Context Protocol (MCP) через stdio:

Категория	Инструмент	Параметры	Описание
Идентичность	`create_agent_identity`	`name, email?, 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-значный код подтверждения за <0.14ms с проверкой владения.
Почтовый ящик	`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?`	Удаляет временный почтовый ящик и очищает сохранённые сообщения.
Протокол задач	`dispatch_agent_task`	`action, description, repository?, branch?, priority?, target_agent?, evidence?, acceptance_criteria?, agent_token?`	Отправляет структурированный рабочий заказ от одного агента другому.
Протокол задач	`claim_agent_task`	`task_id, agent_token`	Атомарно блокирует и назначает задачу агенту-исполнителю, который её запрашивает.
Протокол задач	`update_task_progress`	`task_id, status, commit_sha?, pr_url?, test_results?, note?, agent_token`	Обновляет статус задачи (`running`, `testing`, `pr_opened`) и записывает журнал аудита.
Протокол задач	`complete_agent_task`	`task_id, summary, commit_sha?, pr_url?, test_results?, agent_token`	Закрывает задачу с деталями завершения и генерирует событие завершения.
Протокол задач	`list_agent_tasks`	`status?, agent_token?, limit?`	Перечисляет задачи, отфильтрованные по состоянию жизненного цикла или идентичности агента.
Протокол задач	`get_task_audit_trail`	`task_id, agent_token?`	Получает неизменяемый журнал аудита и историю жизненного цикла задачи.

🚀 Быстрый старт

1. Headless NPM CLI (нулевая настройка)

Мгновенно настройте свои ИИ-инструменты за 1 секунду:

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

# Start MCP stdio server with live daemon SSE event bridge
npx agentbox-mail mcp

# Create an Agent Identity with scoped capabilities
npx agentbox-mail agent create support --email support@mycompany.com --capabilities "inbox.read,email.send"

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

# Launch Web Dashboard
npx agentbox-mail ui

2. Нативное настольное приложение Electron

# 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

🏗️ Архитектура

                                  ┌───────────────────────────┐
                                  │   Inbound Emails & Tasks  │
                                  └─────────────┬─────────────┘
                                                │
                 ┌──────────────────────────────┼──────────────────────────────┐
                 │                              │                              │
                 ▼                              ▼                              ▼
     ┌───────────────────────┐      ┌───────────────────────┐      ┌───────────────────────┐
     │ Hostinger / Titan /   │      │ Raw SMTP Listener     │      │ Inbound HTTP Webhook  │
     │ Google IMAP TLS (993) │      │ (0.0.0.0:2525)        │      │ (POST /v1/inbound)    │
     └───────────┬───────────┘      └───────────┬───────────┘      └───────────┬───────────┘
                 │                              │                              │
                 └──────────────────────────────┼──────────────────────────────┘
                                                │
                                                ▼
                                 ┌─────────────────────────────┐
                                 │   High-Speed Parser Engine  │
                                 │  • 4–8 Digit OTP Isolator   │
                                 │  • Link Safety Engine       │
                                 │  • TaskDetector (Work Order)│
                                 └──────────────┬──────────────┘
                                                │
                                                ▼
                                 ┌─────────────────────────────┐
                                 │ Embedded SQLite Storage     │
                                 │       (`agentbox.db`)       │
                                 │  • Identities & Auth Tokens │
                                 │  • Mailboxes & Messages     │
                                 │  • Resource Ownership Graph │
                                 │  • Agent Tasks & Audit Logs │
                                 └──────────────┬──────────────┘
                                                │
                 ┌──────────────────────────────┼──────────────────────────────┐
                 │                              │                              │
                 ▼                              ▼                              ▼
     ┌───────────────────────┐      ┌───────────────────────┐      ┌───────────────────────┐
     │ Realtime SSE Bus      │      │ MCP Server (stdio)    │      │ Native Desktop App /  │
     │ (`GET /v1/events`)    │      │ Full Tool Interface   │      │ Web Dashboard (:3000) │
     │ (Live Daemon Bridge)  │      │ Object-Level Auth     │      │                       │
     └───────────────────────┘      └───────────────────────┘      └───────────────────────┘

📄 Лицензия

Распространяется под лицензией MIT License. Подробнее см. LICENSE.

Создано с 🖤 RABNEER и сообществом AgentBox Open Source Community

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

CryptoAgentMail
io.github.influqa
Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.
Email Communication
21
email A
dev.primitive
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email Communication
142
AgentMailOAuth
to.agentmail
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Email Communication
2
AgenticEmail A
dev.agenticemail
Hosted email for AI agents: create inboxes, send, receive, and reply over MCP with scoped API keys
Email Communication
2

Related MCP Servers

UnCorreoTemporal
Autonomous Agents App Automation
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.
Updated 6 months ago (2026-04-19 00:24 UTC)
6
MIT
Mailgent MCP Server
Email Security App Automation
loomal-ai
A
license
Not graded
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.
Updated 4 months ago (2026-06-06 10:26 UTC)
9 npm
MIT
Shoot Email
powersurge01
A
license
Not graded
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.
Updated 2 months ago (2026-07-30 18:14 UTC)
MIT
smails
Email Communication
pexni
A
license
Not graded
quality
D
maintenance
Disposable email for humans and AI agents. Enables AI agents to create mailboxes and receive verification emails through an MCP server.
Updated 4 months ago (2026-06-26 11:48 UTC)
37
MIT