邮件测试服务

MCP服务器用于Mailosaur电子邮件测试,支持在VS Code、Claude Desktop等MCP客户端中调试Playwright和其他涉及电子邮件的端到端测试失败问题。

  • by jagypus
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 jagypus/mcp-mailosaur

使用说明

mcp邮件

MCP服务器 Mailosaur 电子邮件测试。调试Playwright和其他e2e测试失败,涉及VS Code、Claude Desktop和其他MCP客户端中的AI代理的电子邮件。

快速开始

git clone https://github.com/jagypus/mcp-mailosaur.git
cd mcp-mailosaur
npm install --ignore-scripts
npm run build

然后将其添加到下面的编辑器配置中。

配置

环境变量

变量 必填 描述
MAILOSAUR_API_KEY 是 您的Mailosaur API密钥(在这里买一个)
MAILOSAUR_SERVER_ID 否 默认服务器ID--使您无需在每次工具调用时都指定它

VS代码(克劳德代码/复制品)

添加到您的 .vscode/mcp.json:

{
  "servers": {
    "mailosaur": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/mcp-mailosaur/dist/index.js"],
      "env": {
        "MAILOSAUR_API_KEY": "your-api-key",
        "MAILOSAUR_SERVER_ID": "your-server-id"
      }
    }
  }
}

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):

{
  "mcpServers": {
    "mailosaur": {
      "command": "node",
      "args": ["/path/to/mcp-mailosaur/dist/index.js"],
      "env": {
        "MAILOSAUR_API_KEY": "your-api-key",
        "MAILOSAUR_SERVER_ID": "your-server-id"
      }
    }
  }
}

可用工具

消息

工具 说明
list_messages 在服务器中列出带有分页和可选功能的邮件 receivedAfter 过滤器
get_message 按ID获取完整的邮件详细信息——HTML正文、文本正文、页眉、附件
search_messages 按发件人、收件人、主题或正文搜索邮件。等待具有可配置超时的匹配。

分析

工具 说明
check_spam 运行SpamAssassin分析——得分、触发规则、通过/失败
check_deliverability 检查SPF、DKIM、DMARC、阻止列表和DNS记录

调试工作流示例

“我的e2e测试显示未收到验证电子邮件”

让你的AI代理搜索电子邮件:

在Mailosaur中搜索发送至的电子邮件test-user@yourserver.mailosaur.net在最后10分钟

“正在发送电子邮件,但可能是垃圾邮件”

检查邮件ID xxx的垃圾邮件评分

“我想验证电子邮件内容是否正确”

在我的Mailosaur收件箱中获取最新邮件的完整详细信息

许可证

麻省理工学院