临时邮箱验证服务

UnCorreoTemporal MCP服务器专注于自动化注册和电子邮件验证工作流,提供临时邮箱创建、验证邮件等待、验证链接提取等功能。

  • by francofuji
  • TypeScript
  • 混合部署
  • 更新于
在 GitHub 查看 francofuji/uncorreotemporal-mcp-server

使用说明

非颞叶mcp

MCP服务器 不正确的时间,专注于自主注册和电子邮件验证工作流程。

架构演示

AI Agent
   |
   | MCP
   v
Temporary Email MCP Server
   |
   v
UnCorreoTemporal API

远程连接(无需安装)

直接连接到公共端点——无需本地安装:

{
  "mcpServers": {
    "uncorreotemporal-mcp": {
      "url": "https://uncorreotemporal.com/mcp"
    }
  }
}

公共端点可免费用于测试。对于生产工作负载,设置自己的 UCT_API_KEY 通过本地安装。

安装

克劳德代码

claude mcp add uncorreotemporal -e UCT_API_KEY=uct_your_key_here -- uvx uncorreotemporal-mcp

克劳德桌面(claude_desktop_config.json)

{
  "mcpServers": {
    "uncorreotemporal": {
      "command": "uvx",
      "args": ["uncorreotemporal-mcp"],
      "env": {
        "UCT_API_KEY": "uct_your_key_here"
      }
    }
  }
}

获取API密钥: uncortemporal.com.

快速启动(30秒)

uvx uncorreotemporal-mcp

或者运行本地项目版本:

UCT_API_KEY=uct_your_key_here \
uv run uncorreotemporal-mcp

最小工作流示例

inbox = await create_signup_inbox("github")
email = await wait_for_verification_email(inbox["inbox_id"])
link = await extract_verification_link(
    inbox_id=inbox["inbox_id"],
    message_id=email["message_id"],
)

公共工具

  • create_signup_inbox
  • wait_for_verification_email
  • get_latest_email
  • extract_otp_code
  • extract_verification_link
  • complete_signup_flow

新v1工具: complete_signup_flow

跑:

  1. 创建收件箱
  2. 等待验证电子邮件
  3. 提取验证链接+OTP

输入:

{
  "service_name": "github",
  "timeout_seconds": 90,
  "poll_interval_seconds": 3,
  "subject_contains": "verify",
  "from_contains": "noreply",
  "preferred_domains": ["github.com"],
  "ttl_minutes": 30
}

输出:

{
  "status": "success",
  "inbox_id": "agent42@uncorreotemporal.com",
  "email": "agent42@uncorreotemporal.com",
  "verification_message": {
    "message_id": "msg-1",
    "subject": "Verify your email",
    "from_address": "noreply@example.com",
    "received_at": "2026-03-08T11:30:00Z"
  },
  "verification_link": "https://example.com/confirm?t=abc",
  "otp_code": "483920",
  "link_candidates": ["https://example.com/confirm?t=abc"],
  "otp_candidates": ["483920"]
}

status 可以是 success, partial_success,或 timeout.

工具I/O摘要

create_signup_inbox(service_name, ttl_minutes?)

退货:

{
  "inbox_id": "agent42@uncorreotemporal.com",
  "email": "agent42@uncorreotemporal.com",
  "expires_at": "2026-03-08T12:00:00Z",
  "service_name": "github"
}

wait_for_verification_email(inbox_id, timeout_seconds?, poll_interval_seconds?, subject_contains?, from_contains?)

退货:

{
  "status": "received",
  "message_id": "msg-1",
  "received_at": "2026-03-08T11:30:00Z",
  "subject": "Verify your account",
  "from_address": "noreply@example.com",
  "timeout_seconds": 90
}

get_latest_email(inbox_id, mark_as_read?)

返回完整的消息正文和元数据。

extract_otp_code(message_text? | inbox_id+message_id, otp_length_min?, otp_length_max?)

退货:

{
  "otp_code": "483920",
  "candidates": ["483920"]
}

extract_verification_link(message_text? | inbox_id+message_id, preferred_domains?)

退货:

{
  "verification_link": "https://example.com/confirm?t=abc",
  "candidates": ["https://example.com/confirm?t=abc"]
}

配置

环境变量:

  • UCT_API_KEY (必填)
  • UCT_API_BASE (可选,默认值: https://uncorreotemporal.com)
  • UCT_HTTP_TIMEOUT_SECONDS (可选,默认值: 20)
  • UCT_MCP_TRANSPORT (可选, stdio 默认情况下;还支持 streamable-http 和 sse)
  • UCT_MCP_HOST (可选,默认值: 0.0.0.0)
  • UCT_MCP_PORT (可选,默认值: 8000)
  • UCT_MCP_PATH (可选,默认值: /mcp)

重要提示: inbox_id == email address.

示例

看 /examples:

  • simple_workflow.py
  • openai_agent_signup.py
  • langchain_agent_signup.py
  • agent_creates_account.py

试运行:

uv run python examples/simple_workflow.py --dry-run

码头工人

构建:

docker build -t uncorreotemporal-mcp .

运行stdio模式:

docker run --rm -i \
  -e UCT_API_KEY=uct_your_key_here \
  uncorreotemporal-mcp

运行可流式传输的http模式:

docker run --rm -p 8000:8000 \
  -e UCT_API_KEY=uct_your_key_here \
  -e UCT_MCP_TRANSPORT=streamable-http \
  -e UCT_MCP_PATH=/mcp \
  uncorreotemporal-mcp

突破性变化

删除了旧的低级工具:

  • create_mailbox
  • list_mailboxes
  • get_messages
  • read_message
  • delete_mailbox

迁移图:

  • create_mailbox -> create_signup_inbox
  • get_messages + read_message -> wait_for_verification_email + get_latest_email
  • 多步骤注册编排-> complete_signup_flow

列出资产的目录

已准备好的列表有效载荷 /directory-listings 用于:

  • 模型上下文协议/服务器
  • mcp.so
  • 很棒的mcp

公共端点部署

部署模板 https://uncorreotemporal.com/mcp 在里面 /deploy.

发展

uv run pytest
uv run uncorreotemporal-mcp