Resend MCP Server – 快速概览

它是什么 – 一个轻量级的 Node-JS 服务（作为 resend-mcp NPM 包提供），允许支持 AI 的“MCP”客户端（如 Claude、Cursor、Copilot 或任何支持 MCP (Message-Control-Protocol) 的工具）直接与 Resend 电子邮件发送平台进行通信。实际上，它将语言模型转变为功能齐全的电子邮件自动化助手：发送邮件、管理联系人、运行广播、处理入站消息等。

为什么它很重要 – 如果没有这个桥接器，你必须在提示词中编写自定义 API 调用或编写单独的脚本。MCP 服务器公开了一套 稳定且对语言模型友好 的命令集（README 中列出的 MCP Server Tools），模型可以通过自然语言指令调用这些命令，从而让模型充当电子邮件运营经理的角色。

两种运行方式

模式	工作原理	使用场景
远程 MCP 服务器 (由 Resend 托管)	将客户端指向 `https://mcp.resend.com/mcp`。客户端会打开浏览器进行 OAuth 认证，或者你提供一个 Resend API key。	设置最快，适合不想运行本地进程的基于 Web 的代理（Claude、Cursor 等）。
本地 MCP 服务器 (本包)	通过 `npx resend-mcp` (默认 stdio) 或 `npx resend-mcp --http` 自行运行服务器。你需要提供 Resend API key，并可选择提供默认发件人地址。	当你需要完全控制、在防火墙后运行或集成到私有 CI/代理环境时使用。

两种模式公开相同的工具集；唯一的区别是传输方式（stdio 与 Streamable HTTP）。

入门指南 (本地, stdio – 默认方式)

# 一行命令为任何检测到的 MCP 客户端注册服务器
npx add-mcp resend-mcp --name resend --env "RESEND_API_KEY=re_XXXXX"

将 re_XXXXX 替换为你的 Resend API key。

之后，在像 Claude Code 这样的客户端中，你可以直接运行：

claude mcp add resend -e RESEND_API_KEY=re_XXXXX -- npx -y resend-mcp

客户端将作为子进程启动服务器，通过 stdio 与其通信，你就可以开始使用电子邮件工具了。

HTTP 模式 (适用于无头代理或自定义代理)

# 启动监听 3000 端口的服务器
npx -y resend-mcp --http --port 3000

客户端随后连接到 http://127.0.0.1:3000/mcp 并发送带有其 Resend API key 的 Bearer 头部。

你也可以将服务器嵌入到另一个 Node 服务中：

import { runHttp } from 'resend-mcp/http';
const server = await runHttp({ senderEmailAddress: "me@mydomain.com" }, 3000);

服务器默认验证 Host 头部（防止 DNS 重绑定攻击）。当位于反向代理后时，请设置 --host 0.0.0.0 或 --allowed-hosts。

MCP 服务器的功能 (工具列表)

Emails – 发送、列出、取消、更新、批量发送、添加附件（本地、URL、base64）、定时发送、标签、自定义头部、幂等性。
Received mail – 列出入站消息、下载附件。
Templates – 使用 {{{VARIABLE}}} 占位符的 CRUD 操作。
Contacts & Segments – 管理地址簿、CSV 导入、自定义属性、主题订阅。
Broadcasts & Automations – 创建营销活动、跟踪打开/点击、定时发送、预览、复制。
Events & Topics – 触发自动化、管理订阅主题。
Domains – 验证、配置跟踪/TLS、管理声明。
Suppressions – 添加/移除退信/投诉条目、手动禁止联系列表。
Webhooks – CRUD、查看投递历史、重放事件、轮换签名密钥。
Logs & Usage – 检查 API 请求日志、查看配额/使用统计。
Editor integration – 连接到 Resend 的可视化编辑器进行协作草稿编辑。

所有这些都作为 MCP 工具 公开，LLM 可以通过简单的类似 JSON 的负载调用它们，使电子邮件工作流自动化成为模型能力的自然延伸。

配置选项

标志 / 环境变量	用途
`--key` / `RESEND_API_KEY`	stdio 模式的 API key（HTTP 模式从客户端的 Bearer token 获取）。
`--sender` / `SENDER_EMAIL_ADDRESS`	默认“发件人”地址（必须属于已验证的域名）。
`--reply-to` / `REPLY_TO_EMAIL_ADDRESSES`	默认回复地址（可重复）。
`--http`	切换到 HTTP 传输。
`--port` / `MCP_PORT`	HTTP 模式的端口（默认 3000）。
`--host` / `MCP_HOST`	HTTP 的主机验证（默认 127.0.0.1）。
`--allowed-hosts` / `MCP_ALLOWED_HOSTS`	位于代理后时的 Host 头部白名单。
`--allowed-file-dirs` / `MCP_ALLOWED_FILE_DIRS`	服务器可以读取本地附件文件的目录（除非设置，否则在 HTTP 下禁用）。

谁会使用它？

构建 AI 代理的开发者，他们需要发送事务性或营销邮件，而无需编写原始 HTTP 调用。
使用 Claude、Cursor、Copilot 或其他 MCP 兼容编辑器的团队，他们希望 LLM 管理新闻通讯、支持工单或自动回复。
企业，他们倾向于自托管桥接器以符合合规性，或在企业代理后运行。

常用客户端快速备忘单

// Cursor / Claude Desktop (stdio)
{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": { "RESEND_API_KEY": "re_XXXXX" }
    }
  }
}

// HTTP 模式 (任何客户端)
{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": { "Authorization": "Bearer re_XXXXX" }
    }
  }
}

总结 – resend-mcp 是一个轻量级的开源胶水层，允许现代基于 LLM 的助手将 Resend 的电子邮件平台视为一流的、命令驱动的服务，无论是通过托管端点还是自运行的 Node 服务器。

resend/resend-mcp