Resend MCP 服务器

用于 Resend 平台的 MCP 服务器。直接从任何 MCP 客户端（如 Claude Desktop、Cursor 或 Claude Code）发送和接收电子邮件、管理联系人、广播、域名等。

功能

• 电子邮件 — 发送、列出、获取、取消、更新和批量发送电子邮件。支持 HTML、纯文本、附件（本地文件、URL 或 base64）、抄送/密送、回复地址、定时发送、标签和基于主题的发送。

• 接收的电子邮件 — 列出并阅读收到的电子邮件。列出并下载收到的电子邮件附件。

• 联系人 — 创建、列出、获取、更新和删除联系人。管理细分成员资格和主题订阅。支持自定义联系人属性。

• 广播 — 创建、发送、列出、获取、更新和删除广播活动。支持定时发送、个性化占位符和预览文本。

• 域名 — 创建、列出、获取、更新、删除和验证发件人域名。配置跟踪、TLS 以及发送/接收功能。

• 细分 — 创建、列出、获取和删除受众细分。

• 主题 — 创建、列出、获取、更新和删除订阅主题。

• 联系人属性 — 创建、列出、获取、更新和删除自定义联系人属性。

• API 密钥 — 创建、列出和删除 API 密钥。

• Webhook — 创建、列出、获取、更新和删除用于事件通知的 Webhook。

Related MCP server: blastengine-mailer

设置

创建一个免费的 Resend 账户并 创建 API 密钥。要向您自己的地址之外的地址发送邮件，您需要 验证您的域名。

使用方法

该服务器支持两种传输模式：stdio（默认）和 HTTP。

Stdio 传输（默认）

Claude Code

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

Cursor

打开命令面板并选择 "Cursor Settings" > "MCP" > "Add new global MCP server"。

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

Claude Desktop

打开 Claude Desktop 设置 > "Developer" 选项卡 > "Edit Config"。

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

HTTP 传输

通过 HTTP 运行服务器以进行远程或基于 Web 的集成。在 HTTP 模式下，每个客户端通过在 Authorization 请求头中传递其 Resend API 密钥作为 Bearer 令牌来进行身份验证。

启动服务器：

npx -y resend-mcp --http --port 3000

服务器将在 http://127.0.0.1:3000 上监听，并使用 Streamable HTTP 在 /mcp 处公开 MCP 端点。

Claude Code

claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Cursor

打开命令面板并选择 "Cursor Settings" > "MCP" > "Add new global MCP server"。

{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

您还可以通过 MCP_PORT 环境变量设置端口：

MCP_PORT=3000 npx -y resend-mcp --http

选项

您可以传递额外的参数来配置服务器：

• --key: 您的 Resend API 密钥（仅限 stdio 模式；HTTP 模式使用来自客户端的 Bearer 令牌）

• --sender: 来自已验证域名的默认发件人电子邮件地址

• --reply-to: 默认回复电子邮件地址（可多次指定）

• --http: 使用 HTTP 传输而不是 stdio（默认：stdio）

• --port: 使用 --http 时的 HTTP 端口（默认：3000，或 MCP_PORT 环境变量）

环境变量：

• RESEND_API_KEY: 您的 Resend API 密钥（stdio 必需，HTTP 可选，因为客户端通过 Bearer 令牌传递）

• SENDER_EMAIL_ADDRESS: 来自已验证域名的默认发件人电子邮件地址（可选）

• REPLY_TO_EMAIL_ADDRESSES: 以逗号分隔的回复电子邮件地址（可选）

• MCP_PORT: 使用 --http 时的 HTTP 端口（可选）

本地开发

1. 克隆此项目并构建：

git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build

2. 要使用本地构建，请将 npx 命令替换为您本地构建的路径：

Claude Code (stdio):

claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- node ABSOLUTE_PATH_TO_PROJECT/dist/index.js

Claude Code (HTTP):

claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Cursor / Claude Desktop (stdio):

{
  "mcpServers": {
    "resend": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/dist/index.js"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Cursor (HTTP):

{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

使用 MCP 客户端进行实时测试

在开发时，您可以在编辑代码的同时在真实的 MCP 客户端会话中测试更改。

思路：运行 tsc --watch 以持续重新构建 dist/，并将单独的 MCP 客户端指向来自不同目录的已构建 dist/index.js。当您想要获取代码更改时，请重启 MCP 客户端会话（MCP 服务器是长寿命的 stdio 进程，不会热重载）。

Claude Code 示例：

1. 运行 TypeScript 监视器以在保存时自动重新构建：

   pnpm tsc --watch

2. 在单独的目录中，创建一个指向构建输出的 .mcp.json：

   mkdir -p /tmp/mcp-test

   // /tmp/mcp-test/.mcp.json
   {
     "mcpServers": {
       "resend-dev": {
         "command": "node",
         "args": ["/absolute/path/to/resend-mcp/dist/index.js"],
         "env": {
           "RESEND_API_KEY": "re_xxxxxxxxx"
         }
       }
     }
   }

3. 从该目录启动 Claude Code 并使用 MCP 工具。进行代码更改后，启动一个新的 Claude Code 会话以获取新的构建。

同样的原则适用于任何 MCP 客户端 — 将您的测试环境与开发环境分开，使用 dist/index.js 的绝对路径，并在重新构建后重新连接 MCP 服务器。

使用 MCP Inspector 进行测试

注意： 确保您已先构建项目（请参阅上面的 本地开发 部分）。

使用 Stdio 传输

1. 设置您的 API 密钥：

   export RESEND_API_KEY=re_your_key_here

2. 启动 inspector：

   pnpm inspector

3. 在浏览器中（Inspector UI）：

   • 选择 stdio（启动进程）。

   • Command: node

   • Args: dist/index.js（或 dist/index.js 的完整路径）

   • Env: RESEND_API_KEY=re_your_key_here（如果您已经在同一个终端中导出了它，则可以留空）。

   • 点击 Connect，然后使用 "List tools" 验证服务器是否正常工作。

使用 HTTP 传输

1. 在一个终端中启动 HTTP 服务器：

   node dist/index.js --http --port 3000

2. 在另一个终端中启动 inspector：

   pnpm inspector

3. 在浏览器中（Inspector UI）：

   • 选择 Streamable HTTP（连接到 URL）。

   • URL: http://127.0.0.1:3000/mcp

   • 添加自定义请求头：Authorization: Bearer re_your_key_here 并激活开关。

   • 点击 Connect，然后使用 "List tools" 验证服务器是否正常工作。