Tempmail MCP

MCP运维云端

提供方 Vozec

运维云端 stdio · 本地进程 Token 社区 / 第三方 Claude
查看接入方式

一个自托管的临时邮箱REST API,内置Web UI和可选MCP服务器,聚合多个一次性邮箱提供商。

一句话选型结论

按资料字段整理

Tempmail MCP 属于运维云端类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 12 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量12暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

临时邮箱Python本地部署RESTAPI自托管一次性邮箱WebUIMCP服务器

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
python -m src.mcp_server

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 12 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 12 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Tempmail MCP当前 12 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Vozec上游标注的维护方 Vozec
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.6 KB
来自项目仓库与上游目录的原文,未做删改

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)```bash

cp .env.example .env

edit .env if needed (Gmail credentials, ports, …)

docker compose up -d


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

______________________________________________________________________

## 配置(`.env`)

|变量|默认值|描述|
|---|---|---|
| `HOST` | `0.0.0.0` |绑定地址|
| `PORT` | `8000` |HTTP端口|
| `RELOAD` | `false` |Uvicorn热重载(仅限开发人员)|
| `ENABLE_FRONTEND` | `true` |提供web UI|
| `FLARESOLVERR_URL` | `http://localhost:8191` |FlareSolverr端点|
| `HEALTH_CHECK_ON_STARTUP` | `true` |在启动时探测所有提供程序并禁用故障|
| `SHARED_EMAILS_PATH` | `shared_emails.json` |服务器端固定电子邮件存储的路径|
| `GMAIL_EMAIL` |--| Gmail地址(适用于Gmail IMAP提供商)|
| `GMAIL_APP_PASSWORD` |--| Gmail应用程序密码|

______________________________________________________________________

## REST API

### 系统

|方法|路径|描述|
|---|---|---|
| `GET` | `/api/health` |所有提供者的健康状况(如果一切正常,则为200,如果降级,则为207)|

**回应 `GET /api/health`**```json
{
"healthy": true,
"providers": {
"mail.tm":    { "status": "ok" },
"mailticking": { "status": "disabled", "failures": 3 }
}
}

提供商

方法 路径 描述
GET /api/providers 列出所有处于启用/失败状态的提供程序
POST /api/providers/{name}/disable 手动禁用提供程序
POST /api/providers/{name}/enable 重新启用提供程序并重置故障计数器
GET /api/domains?name= 列出提供程序的可用域

回应 GET /api/providers```json
[
{ "name": "gmail", "disabled": false, "failures": 0 },
{ "name": "mail.tm", "disabled": false, "failures": 0 },
{ "name": "mailticking","disabled": true, "failures": 3 }
]


______________________________________________________________________

### 电子邮件

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

|方法|路径|描述|
|---|---|---|
| `POST` | `/api/email?name=` |创建新的临时邮箱|
| `GET` | `/api/email/{email}/messages?token=X&name=Y` |列出邮箱的邮件|
| `GET` | `/api/email/{email}/message/{id}?token=X&name=Y` |获取完整消息(带正文)|
| `DELETE` | `/api/email/{email}?token=X&name=Y` |删除邮箱|

**请求 `POST /api/email`**```json
{
"min_name_length": 10,
"max_name_length": 10,
"domain": null
}

回应 POST /api/email```json
{
"email": "randomname@mail.tm",
"token": "eyJ...",
"provider": "mail.tm"
}


**回应 `GET /api/email/{email}/messages`**```json
[
{
"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}```json
{
"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 }
]
}


______________________________________________________________________

### 共享/固定电子邮件

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

|方法|路径|描述|
|---|---|---|
| `GET` | `/api/shared` |列出所有固定电子邮件帐户|
| `POST` | `/api/shared` |固定电子邮件(对所有客户端可见)|
| `PATCH` | `/api/shared/{email}` |重命名固定电子邮件(更新标签)|
| `DELETE` | `/api/shared/{email}` |不愉快的电子邮件|

**请求 `POST /api/shared`**```json
{
"email": "randomname@mail.tm",
"token": "eyJ...",
"provider": "mail.tm",
"label": "My shared inbox"
}

回应 GET /api/shared```json
[
{
"email": "randomname@mail.tm",
"token": "eyJ...",
"provider": "mail.tm",
"label": "My shared inbox",
"pinned_at": 1742900000
}
]


______________________________________________________________________

## 提供商

优先顺序(第一个健康提供者获胜):

|优先级|名称|类型|需要FlareSolverr |备注|
|---|---|---|---|---|
| 1 | `gmail` |IMAP |否|需要 `GMAIL_EMAIL` + `GMAIL_APP_PASSWORD` |
| 2 | `mail.tm` |REST API |否|最可靠的回退|
| 3 | `tempmail.io` |REST API |否|可靠|
| 4 | `mailticking` |刮擦|是| CF保护|
| 5 | `tempmailo` |刮擦|是| CF保护|
| 6 | `tempail` |刮擦|是|可能被reCAPTCHA阻止|

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

______________________________________________________________________

## MCP服务器

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

### HTTP传输(推荐)

添加到MCP配置(`~/.mcp.json` 对于克劳德代码, `~/.config/claude/claude_desktop_config.json` 克劳德桌面版):```json
{
"mcpServers": {
"tempmail": {
"type": "http",
"url": "https://your-host/mcp/"
}
}
}

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

独立标准输入模式```bash

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


### 可用工具

|工具|说明|
|---|---|
| `list_providers` |列出所有具有状态的提供商(`disabled`, `failures`) |
| `disable_provider` |手动禁用提供程序|
| `enable_provider` |重新启用提供程序并重置故障计数器|
| `get_domains` |列出提供程序的可用域|
| `create_email` |创建新的一次性邮箱|
| `get_messages` |在收件箱中轮询新邮件|
| `read_message` |阅读邮件的全文|
| `delete_email` |销毁邮箱|
| `list_pinned` |列出所有共享/固定电子邮件|
| `pin_email` |固定邮箱,以便所有客户端都可以重复使用|
| `unpin_email` |删除固定电子邮件|
| `rename_email` |更新固定电子邮件的显示标签|

______________________________________________________________________

## 发展```bash
pip install -r src/requirements.txt
RELOAD=true python -m src.main

FlareSolverr(CF保护提供商需要):bash docker run -p 8191:8191 ghcr.io/flaresolverr/flaresolverr:latest

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Tempmail MCP 怎么安装?

在客户端按下面的安装命令接入:python -m src.mcp_server。装完在客户端配置里引用同一个包或端点。

Tempmail MCP 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Tempmail MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Tempmail MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Tempmail MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Tempmail MCP 能提供哪些能力?

资料显示约 12 个工具;能力标签包括 Python、Claude、自托管。具体工具清单以官方文档为准。

Tempmail MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Tempmail MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。