一次性邮箱服务

为AI代理提供一次性邮箱地址,支持自主注册、收发邮件及验证码处理。

  • by linus-phobomail
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 linus-phobomail/phobomail

使用说明

📬 PhoboMail

人工智能代理的一次性电子邮件地址。

PhoboMail为AI代理提供了自己的 @phobomail.com 电子邮件地址——即时,无需人工。代理可以通过MCP完全自主地注册、发送、接收和等待验证电子邮件。

MCP端点

https://mcp.phobomail.com/mcp

不需要注册API密钥。注册后,将密钥作为 Authorization: Bearer <api_key> 在所有后续请求中。

快速入门

1.注册(无需身份验证)

POST https://mcp.phobomail.com/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "register_email",
    "arguments": { "name": "my-agent" }
  }
}

答复:

Registered!
Email: my-agent@phobomail.com
API Key: pm_...

IMPORTANT: All future MCP calls require this api_key as an HTTP header.
Set: Authorization: Bearer pm_...

2.所有其他呼叫都需要Bearer标头

POST https://mcp.phobomail.com/mcp
Authorization: Bearer pm_...
Content-Type: application/json

可用工具

工具 说明
register_email 注册新的代理电子邮件(无身份验证)
read_inbox 列出收到的电子邮件。过滤器: q (关键字), from (发件人)
get_email 按ID阅读完整的电子邮件内容
send_email 从您的@phobomail.com地址发送电子邮件
read_sent 列出已发送的电子邮件。过滤器: q (关键字), to (收件人)
delete_email 按ID删除电子邮件
wait_for_email 轮询收件箱,直到收到匹配的电子邮件(非常适合OTP)

用例

  • GitHub/服务注册 --代理商需要一封电子邮件来注册外部服务
  • OTP处理 — wait_for_email 轮询,直到验证码到达
  • 代理间通信 --代理可以在会话之间互相发送电子邮件
  • 审计跟踪 --发送的电子邮件存储在服务器端,在代理重新启动后仍然有效

建筑

完全基于Cloudflare的免费层构建:

  • 电子邮件路由 --捕获所有规则路由 @phobomail.com 邮件给工人
  • 工人 -REST API+MCP服务器
  • 键值 --存储收件箱、已发送邮件、代理注册表
  • 重发 --事务性电子邮件发送

限制

  • 50个代理插槽(免费层)
  • 名称:3-32个字符,小写字母,数字,连字符

自足执行

克隆此仓库并部署到您自己的Cloudflare帐户:

# Deploy REST API worker
cd linus-worker
# Set your Resend API key
npx wrangler secret put RESEND_API_KEY
npx wrangler deploy

# Deploy MCP server
cd ../phobomail-mcp
npm install
npx wrangler deploy

您还需要:

  1. 具有Cloudflare DNS的域
  2. Cloudflare电子邮件路由已启用,可实现全面覆盖→ 你的工人
  3. 上的已验证发送域 重发