MCP Server - 临时邮件管理

使用ChatTempMail API进行临时邮件管理的MCP（模型上下文协议）服务器。

中文文档

功能

邮件管理

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

消息管理

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

Webhook配置

• ✅ 获取Webhook配置
• ✅ 设置Webhook配置

安装与使用

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"
      }
    }
  }
}

通过包管理器安装：

{
  8 "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客户端应用程序。

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

Webhook配置工具

get_webhook_config

获取当前的Webhook配置信息。

参数： 无

set_webhook_config

设置或更新Webhook配置。

参数：

• url (必需)：Webhook URL地址
• enabled (必需)：是否启用Webhook

使用示例

获取可用域名

请获取所有可用的邮件域名。

创建临时邮件

请使用域名 "chat-tempmail.com" 创建一个名为 "test" 的临时邮件地址，有效期为1小时。

查看邮件消息

请查看邮件ID "c2c4f894-c672-4d5b-a918-abca95aff1f7" 中的所有消息。

查看消息详情

请查看邮件ID "c2c4f894-c672-4d5b-a918-abca95aff1f7" 中消息ID "fd13a8df-1465-4fbc-a612-ca7311c31ff2" 的详细内容。

注意事项

• API密钥是通过环境变量 TEMPMAIL_API_KEY 进行配置的，请确保其安全，不要公开暴露
• 基础URL可以通过环境变量 TEMPMAIL_BASE_URL 自定义（默认为 https://chat-tempmail.com）
• 临时邮件将根据设定的过期时间自动失效
• 使用 nextCursor 进行分页查询以获取更多数据
• 确保在您的MCP客户端配置中正确设置了环境变量

许可证

MIT

贡献

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