resend-mcp-server

Resend MCP Server

一个用于 Resend 的 MCP 服务——将任何兼容 MCP 的客户端连接到 Resend 事务性邮件 API。

这是什么？

一个 MCP（Model Context Protocol） 服务，让 AI 助手和 Agent 能通过自然语言全面使用 Resend 的邮件 API——发送单封或批量邮件、管理发件域名、API 密钥、受众和联系人。

可搭配 Claude Desktop、Cursor、Windsurf、Cline、Continue 或任何兼容 MCP 的客户端使用，发送邮件、管理基础设施，并围绕邮件构建自动化。

为什么使用它？

• 内置 18 个工具——涵盖邮件发送（单封和批量）、域名、API 密钥、受众和联系人
• 通过对话发送邮件——只需说“给 [email protected] 发送一封欢迎邮件”即可
• 管理基础设施——创建、验证和删除域名，创建和撤销 API 密钥，管理联系人
• 批量发送——单次 API 调用最多发送 100 封邮件
• 完整的联系人增删改查——在各个受众中创建、读取、更新和删除联系人
• 自动限制速率——遵循 Resend 免费层级的 10 req/s 限制，并在收到 429 时重试
• 适用于所有 MCP 客户端——Claude Desktop、Cursor、Windsurf、Cline、Continue 等

快速开始

添加到 MCP 客户端配置中（例如 claude_desktop_config.json）：

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp-server"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxxxxx"
      }
    }
  }
}

前往 resend.com/api-keys 获取免费 API 密钥。

使用方法

可以向 AI 助手提出以下请求：

• “给 [email protected] 发一封邮件，感谢她注册”
• “列出我最近发送的 5 封邮件”
• “ID 为 abc-123 的邮件发生了什么？”
• “为 mail.acme.com 创建一个新的发件域名”
• “验证域名 domain-xyz”
• “创建一个名为 'production-server' 的新 API 密钥”
• “将 [email protected] 添加到受众 audience-1”

工具

工具	描述
send_email	发送事务性邮件（HTML 或纯文本，支持抄送、密送和回复地址）
send_batch_email	单次 API 调用最多发送 100 封邮件
list_emails	列出最近发送的邮件及其投递状态
get_email	按 ID 获取指定邮件的详细信息
create_domain	添加新的发件域名
list_domains	列出账户中的所有发件域名
verify_domain	触发域名的 DNS 验证
delete_domain	移除发件域名
create_api_key	创建新的 API 密钥（完整权限、仅发送权限或限定域名范围）
list_api_keys	列出所有 API 密钥（隐藏令牌）
delete_api_key	按 ID 删除 API 密钥
list_audiences	列出账户中的所有受众
create_audience	创建新的受众以整理联系人
list_contacts	列出受众中的联系人
get_contact	按 ID 获取指定联系人的详细信息
create_contact	将新联系人添加到受众
update_contact	更新联系人的邮箱、姓名或订阅状态
delete_contact	从受众中移除联系人

使用场景

事务性邮件自动化

“向每位新注册用户发送欢迎邮件”——通过自然语言自动处理用户引导流程、收据和通知。无需再在邮件控制面板之间来回切换。

域名管理

“添加 mail.acme.com 作为发件域名并验证”——通过 AI 助手管理 DNS 记录、DKIM 和 SPF，无需登录 Resend 的控制台。

联系人和受众管理

“将 [email protected] 添加到我的 VIP 受众”——无需操作电子表格，即可构建联系人列表并进行细分。支持对联系人和受众执行完整的增删改查操作。

批量营销活动

“向 audience-1 中的所有联系人发送这份新闻简报”——一次调用即可批量发送最多 100 封邮件。非常适合新闻简报、产品公告或重新互动营销活动。

基础设施审计

“列出我的所有 API 密钥和域名”——几秒钟内即可审计 Resend 设置。查看哪些密钥处于启用状态、哪些域名已验证，并清理过期资源。

安全性

• 需要 API 密钥——Resend API 密钥通过环境变量传递，绝不会记录日志或存储在文件中。
• 不访问本地文件——不会读取或写入计算机上的任何文件。
• 无 Shell 访问权限——不会执行命令或启动进程。
• 速率限制——自动将请求限制在约 9 次/秒，以符合 Resend 免费套餐的限制。
• 开源——采用 MIT 许可证。可在 GitHub 查看代码。

故障排除

速率限制错误（429）

服务会在收到 429 错误时自动重试，并等待 2 秒。免费套餐允许每秒 10 次请求。服务会将请求限制在约 9 次/秒，以确保安全。如果频繁遇到此问题，请考虑升级 Resend 套餐。

“Invalid API key” 错误

确认 RESEND_API_KEY 以 re_ 开头，并且在 resend.com/api-keys 处处于启用状态。密钥创建后最多需要 30 秒才能生效。

服务无法启动

确保已安装 Node.js 18+：node --version。如果使用 npx，请确保 npm 为最新版本：npm install -g npm@latest。

MCP 客户端无法连接

确认配置路径正确。Claude Desktop 在 macOS 上使用 ~/Library/Application Support/Claude/claude_desktop_config.json，在 Windows 上使用 %APPDATA%\Claude\claude_desktop_config.json。更改配置后，请重启客户端。

邮件未送达

使用 list_emails 检查送达状态。常见问题包括：缺少 DNS 记录（运行 verify_domain）、因地址无效而退信，或域名尚未验证。Resend 控制台会显示详细的 webhook 事件。

要求

• Node.js 18+
• Resend 账户和 API 密钥（RESEND_API_KEY）

速率限制

服务会自动将请求限制在约 9 次/秒，确保低于 Resend 免费套餐每秒 10 次请求的限制。如果仍然遇到 429 错误，服务会等待 2 秒后重试一次。

开发

git clone https://github.com/friendlygeorge/resend-mcp-server.git
cd resend-mcp-server
npm install
npm run build
RESEND_API_KEY=re_xxxx npm start

许可证

MIT