Tempmail MCP

Tempmail MCP

一个自托管的临时电子邮件REST API，带有内置的web UI和可选的MCP服务器。 多个一次性盒内提供程序聚合在一个API后面；启动时会自动检测并禁用损坏的提供程序。

______________________________________________________________________

特性

• 多供应商 --mail.tm、tempmail.io、Gmail（IMAP）、邮件收发、tempmailo、tempail
• 自动回退 --按优先级顺序选择第一个健康的提供者
• 断路器 --连续3次失败的提供商将自动禁用；通过API重新启用
• 启动健康检查 --在第一个请求之前禁用损坏的提供程序
• 网页用户界面 --基于标签的电子邮件客户端、多帐户、本地存储持久性、自动刷新、浏览器通知
• 共享/固定电子邮件 --pin邮箱服务器端，这样每个客户端都可以使用它们
• Swagger文档 — /docs
• MCP服务器 --可选，可由Claude/任何MCP客户端独立使用
• Cloudflare旁路 --via FlareSolverr 对于需要它的提供商

______________________________________________________________________

快速入门（Docker Compose）

cp .env.example .env
# edit .env if needed (Gmail credentials, ports, …)
docker compose up -d

• 网页用户界面→ http://localhost:8000
• 昂首阔步→ http://localhost:8000/docs

______________________________________________________________________

配置(.env)

______________________________________________________________________

REST API

系统

回应 GET /api/health

{
  "healthy": true,
  "providers": {
    "mail.tm":    { "status": "ok" },
    "mailticking": { "status": "disabled", "failures": 3 }
  }
}

______________________________________________________________________

提供商

回应 GET /api/providers

[
  { "name": "gmail",      "disabled": false, "failures": 0 },
  { "name": "mail.tm",    "disabled": false, "failures": 0 },
  { "name": "mailticking","disabled": true,  "failures": 3 }
]

______________________________________________________________________

电子邮件

name 在每个端点上都是可选的——省略表示“自动”（优先级顺序中的第一个健康提供者）。

请求 POST /api/email

{
  "min_name_length": 10,
  "max_name_length": 10,
  "domain": null
}

回应 POST /api/email

{
  "email": "randomname@mail.tm",
  "token": "eyJ...",
  "provider": "mail.tm"
}

回应 GET /api/email/{email}/messages

[
  {
    "id": "abc123",
    "from_addr": "\"Alice\" ",
    "to_addr": "randomname@mail.tm",
    "subject": "Your verification code",
    "body_text": null,
    "body_html": null,
    "created_at": "1742900000",
    "attachments": []
  }
]

回应 GET /api/email/{email}/message/{id}

{
  "id": "abc123",
  "from_addr": "\"Alice\" ",
  "to_addr": "randomname@mail.tm",
  "subject": "Your verification code",
  "body_text": "Your code is 123456",
  "body_html": "...",
  "created_at": "1742900000",
  "attachments": [
    { "filename": "invoice.pdf", "content_type": "application/pdf", "size": 42300, "url": null }
  ]
}

______________________________________________________________________

共享/固定电子邮件

在服务器端固定一个邮箱，这样每个客户端都可以看到并重用它。

请求 POST /api/shared

{
  "email": "randomname@mail.tm",
  "token": "eyJ...",
  "provider": "mail.tm",
  "label": "My shared inbox"
}

回应 GET /api/shared

[
  {
    "email": "randomname@mail.tm",
    "token": "eyJ...",
    "provider": "mail.tm",
    "label": "My shared inbox",
    "pinned_at": 1742900000
  }
]

______________________________________________________________________

提供商

优先顺序（第一个健康提供者获胜）：

在启动时，每个提供者都会被一个真实的 create_email 电话。任何失败的提供程序在处理请求之前都会自动禁用。

______________________________________________________________________

MCP服务器

MCP服务器在以下位置自动暴露 /mcp/ 当FastAPI应用程序运行时，不需要单独的进程。

HTTP传输（推荐）

添加到MCP配置(~/.mcp.json 对于克劳德代码， ~/.config/claude/claude_desktop_config.json 克劳德桌面版）：

{
  "mcpServers": {
    "tempmail": {
      "type": "http",
      "url": "https://your-host/mcp/"
    }
  }
}

注： 尾随斜线 /mcp/ 是必需的。

独立标准输入模式

python -m src.mcp_server

{
  "mcpServers": {
    "tempmail": {
      "command": "python",
      "args": ["-m", "src.mcp_server"],
      "cwd": "/path/to/tempmail-api"
    }
  }
}

可用工具

______________________________________________________________________

发展

pip install -r src/requirements.txt
RELOAD=true python -m src.main

FlareSolverr（CF保护提供商需要）：

docker run -p 8191:8191 ghcr.io/flaresolverr/flaresolverr:latest