mcp-mailtrap

Name: mcp-mailtrap
Author: pijusz

本地服务

github.com/pijusz通信协作36 天前更新

代码仓库

关于 mcp-mailtrap

mcp-mailtrap 将 Mailtrap 邮件操作接入 MCP 客户端，适用于管理邮件投递、联系人和测试的团队。工具涵盖分析、发送、模板、账户管理及沙盒收件箱检查。

主要功能

01查看投递与互动分析
02发送事务性和批量邮件
03管理模板与联系人
04检查沙盒邮件及垃圾邮件分析
05管理域名、账户和令牌

适用场景

01调查投递和互动趋势
02发送或测试邮件
03更新联系人列表和模板
04投递前检查沙盒邮件

MCP 相关

该 MCP 服务向 MCP 客户端提供 Mailtrap 分析、邮件发送、联系人、模板、沙盒、域名和账户操作工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "pijusz-mcp-mailtrap": {
      "command": "npx",
      "args": [
        "-y",
        "mcpj-mailtrap"
      ]
    }
  }
}

启动命令npx -y mcpj-mailtrap

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmcpj-mailtrap0.1.4stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcpj-mailtrap

Mailtrap MCP 服务——通过自然语言查询分析数据、邮件日志、联系人、沙盒测试等。
基于 Bun + TypeScript 构建。支持 Claude、Cursor 和任何 MCP 客户端。

快速开始

1. 获取 API Token

从 Mailtrap API Tokens 获取 API token。

2. 添加到 Claude Code

最简配置

claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- npx mcpj-mailtrap

完整配置

claude mcp add mailtrap \
  -e MAILTRAP_API_TOKEN=your_token \
  -e MAILTRAP_SENDING_TOKEN=your_sending_token \
  -e MAILTRAP_ACCOUNT_ID=12345 \
  -e [email protected] \
  -e MAILTRAP_TEST_INBOX_ID=12345 \
  -- npx mcpj-mailtrap

完成。重启 Claude Code 即可使用这些工具。

如果已安装 Bun，也可以使用 bunx mcpj-mailtrap@latest。通过 npx 运行时需要 Node 18+。

Claude Desktop / Cursor

最简配置

{
  "mcpServers": {
    "mailtrap": {
      "command": "npx",
      "args": ["-y", "mcpj-mailtrap@latest"],
      "env": {
        "MAILTRAP_API_TOKEN": "your_token"
      }
    }
  }
}

完整配置

{
  "mcpServers": {
    "mailtrap": {
      "command": "npx",
      "args": ["-y", "mcpj-mailtrap@latest"],
      "env": {
        "MAILTRAP_API_TOKEN": "your_token",
        "MAILTRAP_SENDING_TOKEN": "your_sending_token",
        "MAILTRAP_ACCOUNT_ID": "12345",
        "MAILTRAP_DEFAULT_FROM_EMAIL": "[email protected]",
        "MAILTRAP_TEST_INBOX_ID": "12345"
      }
    }
  }
}

替代方案：独立二进制文件

从 Releases 下载预构建的二进制文件：

平台	文件
macOS（Apple Silicon）	`mcpj-mailtrap-darwin-arm64`
macOS（Intel）	`mcpj-mailtrap-darwin-x64`
Linux	`mcpj-mailtrap-linux-x64`
Windows	`mcpj-mailtrap-windows-x64.exe`

macOS / Linux：

curl -Lo mcpj-mailtrap https://github.com/pijusz/mcp-mailtrap/releases/latest/download/mcpj-mailtrap-darwin-arm64
chmod +x mcpj-mailtrap
sudo mv mcpj-mailtrap /usr/local/bin/
claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- /usr/local/bin/mcpj-mailtrap

Windows（PowerShell）：

Invoke-WebRequest -Uri "https://github.com/pijusz/mcp-mailtrap/releases/latest/download/mcpj-mailtrap-windows-x64.exe" -OutFile "$env:LOCALAPPDATA\mcpj-mailtrap.exe"
claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- "%LOCALAPPDATA%\mcpj-mailtrap.exe"

工具（46）

分析

工具	描述
`get_stats`	发送统计数据——送达率、退信率、打开率、点击率和垃圾邮件率。可按域名、类别、ESP 或日期分组

邮件日志

工具	描述
`get_email_logs`	列出已发送的邮件，可按状态、流、日期范围、收件人、发件人、主题或类别筛选。基于游标的分页
`get_email_log`	单封邮件详情及送达事件时间线
`get_suppressions`	列出被抑制的邮件（退信、垃圾邮件投诉、退订），并提供 `delete_suppression` 所需的 ID
`delete_suppression`	重新启用向被抑制地址发送邮件
`check_list_hygiene`	查找仍存在于联系人列表中的被抑制邮件，并建议精确的清理操作

发送

工具	描述
`send_email`	通过事务型或批量流发送邮件。支持 HTML、纯文本或模板
`batch_send`	单次请求最多发送 500 封邮件
`send_test_email`	将邮件发送到沙盒收件箱进行测试，可选使用收件箱和发件人的环境变量默认值

模板

工具	描述
`list_templates`	列出所有邮件模板
`get_template`	获取模板详情，包括 HTML/文本正文
`create_template`	创建新模板
`update_template`	更新现有模板
`delete_template`	删除模板
`render_react_email`	将 react-email 组件文件（`.tsx`、`.jsx`、`.js`、`.mjs`）渲染为 HTML + 纯文本

联系人

工具	描述
`create_contact`	创建联系人，设置邮箱、自定义字段和列表归属
`get_contact`	通过 UUID 或邮箱获取联系人
`update_contact`	更新联系人字段、列表归属和订阅状态
`delete_contact`	删除联系人
`trigger_contact_event`	为联系人触发自动化流程
`list_contact_lists`	列出所有联系人列表
`get_contact_list`	获取单个联系人列表
`create_contact_list`	创建新的联系人列表
`update_contact_list`	重命名联系人列表
`delete_contact_list`	删除联系人列表
`manage_contact_field`	列出、获取、创建、更新或删除自定义联系人字段
`import_contacts`	批量导入最多 50k 个联系人，或检查导入状态
`export_contacts`	开始导出联系人或检查导出状态

Email Sandbox

工具	描述
`list_projects`	列出包含收件箱的沙盒项目
`get_project`	获取单个项目
`manage_project`	创建、更新或删除项目
`list_inboxes`	列出所有沙盒收件箱
`get_inbox`	获取收件箱详情（默认隐藏凭据）
`manage_inbox`	创建、更新、清理、标记为已读、重置凭据或删除
`get_messages`	列出沙盒收件箱中的邮件
`get_message`	以 HTML、文本、原始内容或 EML 格式获取邮件正文，可选择包含附件
`analyze_message`	综合垃圾邮件评分、HTML 分析和邮件头报告
`forward_message`	将测试邮件转发到某个邮箱

域名

工具	描述
`list_domains`	列出发送域名及其 DNS 状态
`get_domain`	获取域名详情，包括 DNS 记录
`manage_domain`	创建或删除发送域名
`send_domain_setup_instructions`	将 DNS 设置说明通过邮件发送给同事

账户

工具	描述
`list_accounts`	列出账户或按 ID 获取账户
`get_billing_usage`	计划限制和当前用量
`manage_account_access`	列出、移除、更新权限或查看资源
`manage_api_token`	列出、获取、创建、删除或重置 API 令牌

配置

变量	必需	默认值	描述
`MAILTRAP_API_TOKEN`	是	—	来自 mailtrap.io/api-tokens 的通用 API 令牌
`MAILTRAP_SENDING_TOKEN`	否	`MAILTRAP_API_TOKEN`	用于事务性和批量 `send.api` 请求的独立令牌
`MAILTRAP_ACCOUNT_ID`	否	自动发现	默认账户 ID
`MAILTRAP_DEFAULT_FROM_EMAIL`	否	—	`send_email` / `send_test_email` 的默认发件人邮箱
`MAILTRAP_TEST_INBOX_ID`	否	—	`send_test_email` 的默认沙盒收件箱 ID
`DEBUG`	否	—	启用调试日志

更新

使用 npx @latest（推荐）：始终获取最新版本，无需手动更新。

使用二进制文件：服务会在启动时检查是否有新版本，如果版本过旧，则向 stderr 输出日志：

[mcpj-mailtrap] Update available: v0.2.0 (current: v0.1.0)

检查已安装的版本：

mcpj-mailtrap --version

开发

需要 Bun。

git clone https://github.com/pijusz/mcp-mailtrap.git
cd mcp-mailtrap
bun install
bun test           # tests
bun run typecheck  # tsc
bun run build      # standalone binary
bun run inspect    # MCP Inspector
bun run check      # biome format + lint

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。