mcp-server-tempmail

🚀 MCP 服务器 - 临时邮箱

这是一个使用 ChatTempMail API 进行临时邮箱管理的 MCP（模型上下文协议）服务器。它能帮助你便捷地管理临时邮箱，实现邮箱和消息的各项操作。

中文文档

✨ 主要特性

邮箱管理

• ✅ 获取可用域名
• ✅ 创建临时邮箱
• ✅ 列出邮箱
• ✅ 删除邮箱

消息管理

• ✅ 获取邮箱消息
• ✅ 查看消息详情
• ✅ 删除消息

网络钩子配置

• ✅ 获取网络钩子配置
• ✅ 设置网络钩子配置

📦 安装指南

1. 获取 API 密钥

1. 访问 chat-tempmail.com
2. 注册并登录账号
3. 在个人资料页面创建 API 密钥

2. 配置 MCP 客户端

将配置添加到你的 MCP 客户端（如 Claude Desktop、Cursor 等），确保在环境变量中设置 API 密钥：

从源代码安装：

{
  "mcpServers": {
    "tempmail": {
      "command": "npx",
      "args": [
        "--from",
        "git+https://github.com/Selenium39/mcp-server-tempmail.git",
        "mcp-server-tempmail"
      ],
      "env": {
        "TEMPMAIL_API_KEY": "your-api-key-here",
        "TEMPMAIL_BASE_URL": "https://chat-tempmail.com"
      }
    }
  }
}

从包管理器安装：

{
  "mcpServers": {
    "tempmail": {
      "command": "npx",
      "args": ["mcp-server-tempmail"],
      "env": {
        "TEMPMAIL_API_KEY": "your-api-key-here",
        "TEMPMAIL_BASE_URL": "https://chat-tempmail.com"
      }
    }
  }
}

⚠️ 重要提示

• 请将 your-api-key-here 替换为你从 chat-tempmail.com 获取的实际 API 密钥。
• TEMPMAIL_BASE_URL 是可选的，若未指定，默认值为 https://chat-tempmail.com。

3. 重启应用程序

配置完成后，重启你的 MCP 客户端应用程序。

📚 详细文档

邮箱管理工具

get_email_domains

获取系统中所有可用的邮箱域名。

参数： 无

create_email

创建一个新的临时邮箱地址。

参数：

• name（必填）：邮箱前缀名称
• domain（必填）：邮箱域名
• expiryTime（必填）：过期时间（毫秒），可选值：
  • 3600000 - 1 小时
  • 86400000 - 1 天
  • 259200000 - 3 天
  • 0 - 永久

list_emails

获取你账户下的所有邮箱地址。

参数：

• cursor（可选）：分页游标

delete_email

删除指定的邮箱地址。

参数：

• emailId（必填）：邮箱 ID

消息管理工具

get_messages

获取指定邮箱地址中的所有消息。

参数：

• emailId（必填）：邮箱 ID
• cursor（可选）：分页游标

get_message_detail

获取指定消息的详细内容。

参数：

• emailId（必填）：邮箱 ID
• messageId（必填）：消息 ID

delete_message

删除指定的消息。

参数：

• emailId（必填）：邮箱 ID
• messageId（必填）：消息 ID

网络钩子配置工具

get_webhook_config

获取当前的网络钩子配置信息。

参数： 无

set_webhook_config

设置或更新网络钩子配置。

参数：

• url（必填）：网络钩子 URL 地址
• enabled（必填）：是否启用网络钩子

💻 使用示例

获取可用域名

Please get all available email domains.

创建临时邮箱

Please create an email named "test" using domain "chat-tempmail.com" with 1 hour validity.

查看邮箱消息

Please view all messages in email ID "c2c4f894-c672-4d5b-a918-abca95aff1f7".

查看消息详情

Please view the detailed content of message ID "fd13a8df-1465-4fbc-a612-ca7311c31ff2" in email ID "c2c4f894-c672-4d5b-a918-abca95aff1f7".

📄 许可证

本项目采用 MIT 许可证。

🤝 贡献

欢迎提交问题和拉取请求。

💡 使用建议

• API 密钥通过 TEMPMAIL_API_KEY 环境变量进行配置，请妥善保管，切勿公开暴露。
• 基础 URL 可以通过 TEMPMAIL_BASE_URL 环境变量进行自定义（默认值为 https://chat-tempmail.com）。
• 临时邮箱将根据设置的过期时间自动过期。
• 使用 nextCursor 进行分页查询以获取更多数据。
• 请确保在 MCP 客户端配置中正确设置环境变量。