UnCorreoTemporal

uncorreotemporal-mcp

用于 UnCorreoTemporal 的 MCP 服务，专注于自主注册和电子邮件验证工作流。

架构演示

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

远程连接（无需安装）

直接连接到公共端点，无需本地安装：

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

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

安装

Claude Code

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

Claude Desktop（claude_desktop_config.json）

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

请在 uncorreotemporal.com 获取 API 密钥。

快速入门（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": "[email protected]",
  "email": "[email protected]",
  "verification_message": {
    "message_id": "msg-1",
    "subject": "Verify your email",
    "from_address": "[email protected]",
    "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。

工具输入/输出摘要

create_signup_inbox(service_name, ttl_minutes?)

返回：

{
  "inbox_id": "[email protected]",
  "email": "[email protected]",
  "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": "[email protected]",
  "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

构建：

docker build -t uncorreotemporal-mcp .

运行 stdio 模式：

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

运行 streamable-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，适用于：

• modelcontextprotocol/servers
• mcp.so
• awesome-mcp

公共端点部署

https://uncorreotemporal.com/mcp 的部署模板位于 /deploy。

开发

uv run pytest
uv run uncorreotemporal-mcp