内容
# guerrillamail-mcp
[](https://www.npmjs.com/package/guerrillamail-mcp)
[](https://www.npmjs.com/package/guerrillamail-mcp)
[](./LICENSE)
[](https://nodejs.org)
用于 [Guerrilla Mail](https://www.guerrillamail.com/) 临时/一次性电子邮件 API 的 MCP 服务器。启动一次性收件箱，轮询邮件，并从任何 MCP 客户端（如 Claude Desktop、Claude Code、Cursor 或其他）读取消息。
**零配置。无需 API 密钥。只需一个命令。**
```bash
npx -y guerrillamail-mcp
```
## 为什么
在 AI 工作流中需要一个临时邮箱（如注册测试、OTP 捕获、临时收件箱），但无需离开代理？这将 Guerrilla Mail 的一次性收件箱直接连接到模型上下文协议（MCP），以便您的代理可以创建地址、监视邮件并读取邮件，所有操作均可自主完成。
## 安装与使用
直接使用 npx 运行，无需安装：
```bash
npx -y guerrillamail-mcp
```
### Claude Desktop
添加到您的 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"guerrillamail": {
"command": "npx",
"args": ["-y", "guerrillamail-mcp"]
}
}
}
```
### Claude Code CLI
```bash
claude mcp add guerrillamail -- npx -y guerrillamail-mcp
```
## 工具
| 工具 | 描述 | 输入参数 |
|------|-------------|--------|
| `get_email_address` | 获取新的临时地址并启动会话。 | `lang`（可选，默认为 `"zh"`） |
| `set_email_user` | 设置会话的地址本地部分。 | `email_user`（必填） |
| `check_inbox` | 检查收件箱；仅使用 `seq` 轮询新邮件。 | `seq`（可选，默认为 `"0"`） |
| `fetch_email` | 获取单个邮件的完整正文（已剥离 HTML）。 | `email_id`（必填） |
| `delete_emails` | 删除一个或多个邮件。 | `email_ids`（必填，`string[]`） |
| `forget_me` | 忘记会话并清除本地状态。 | 无 |
## 注意事项
- 会话状态（`sid_token` + `PHPSESSID` cookie）将在进程生命周期内保存在内存中。
- 无需 API 密钥。使用公共 Guerrilla Mail AJAX 端点。
## 许可证
MIT
