项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器,它利用 Resend API 为大型语言模型 (LLM) 客户端提供邮件发送功能。通过此 MCP 服务器,你可以让 Cursor 或 Claude Desktop 等 LLM 应用直接调用工具发送邮件,无需手动复制粘贴邮件内容,提高工作效率。

主要功能点

  • 邮件发送工具: 提供 'send-email' 工具,允许 LLM 客户端指定收件人、主题、邮件正文(纯文本和 HTML)、以及可选的定时发送时间,通过 Resend API 发送邮件。
  • 灵活的配置: 支持通过命令行参数或环境变量配置 Resend API 密钥、发件人邮箱和回复邮箱,满足不同的部署需求。
  • 兼容多种 LLM 客户端: 已验证与 Cursor 和 Claude Desktop 等 MCP 客户端的兼容性,可以方便地集成到这些工具中使用。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的电脑上已安装 Node.js 和 npm (Node 包管理器)。
  2. 克隆仓库: 将 'mcp-send-email' 仓库克隆到本地:
    git clone https://github.com/resend/mcp-send-email.git
    cd mcp-send-email
  3. 安装依赖: 在项目根目录下运行以下命令安装项目依赖:
    npm install
  4. 构建项目: 运行以下命令编译 TypeScript 代码:
    npm run build
    构建成功后,会在 'build' 目录下生成 'index.js' 文件,这是 MCP 服务器的入口文件。
  5. 获取 Resend API 密钥: 访问 Resend 官网 注册并登录,按照指引设置域名或验证邮箱,并获取 Resend API 密钥。

服务器配置

对于 Cursor 客户端:

在 Cursor 的设置 (Settings) -> MCP -> Add new MCP server 中,添加一个新的 MCP 服务器,配置如下:

  • Name: 自定义服务器名称,例如 'resend-email'
  • Type: 选择 'command'
  • Command: 填写 'node'
  • Arguments: 填写 MCP 服务器脚本的绝对路径,并添加必要的参数。例如:
    ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js --key=YOUR_RESEND_API_KEY --sender=YOUR_SENDER_EMAIL_ADDRESS
    • 'ABSOLUTE_PATH_TO_MCP_SERVER': 替换为 'build/index.js' 文件所在的绝对路径。
    • '--key=YOUR_RESEND_API_KEY': 替换为你的 Resend API 密钥。
    • '--sender=YOUR_SENDER_EMAIL_ADDRESS': (可选)替换为你的默认发件人邮箱地址。如果省略此参数,每次调用 'send-email' 工具时,LLM 客户端都会要求用户提供发件人邮箱。

对于 Claude Desktop 客户端:

打开 Claude Desktop 的设置,找到 MCP 服务器配置部分,添加一个新的 MCP 服务器,配置 JSON 如下:

{
  "mcpServers": {
    "resend-email": {  // 服务器名称,自定义
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"], //  ABSOLUTE_PATH_TO_MCP_SERVER 替换为build/index.js 的绝对路径
      "env": {
        "RESEND_API_KEY": "YOUR_RESEND_API_KEY",  // 替换为你的 Resend API 密钥
        "SENDER_EMAIL_ADDRESS": "YOUR_SENDER_EMAIL_ADDRESS" // (可选)替换为你的默认发件人邮箱地址。如果省略此环境变量,每次调用 send-email 工具时,LLM 客户端都会要求用户提供发件人邮箱。
      }
    }
  }
}

基本使用方法

  1. 启动 MCP 服务器: 在终端中,进入项目根目录,运行配置好的 Cursor 或 Claude Desktop 命令,启动 MCP 服务器。例如,如果配置中 'command' 为 'node', 'args' 为 'ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js --key=YOUR_RESEND_API_KEY',则直接运行该命令即可。
  2. 在 LLM 客户端中使用: 在 Cursor 或 Claude Desktop 中,可以使用自然语言指令 (例如 "发送邮件给 xxx,主题是 xxx,内容是 xxx") 或通过选择邮件内容并使用快捷键 (如 Cursor 的 'cmd+l') 来触发邮件发送工具。
  3. 调用 'send-email' 工具: LLM 客户端会识别邮件发送意图,并调用 'send-email' 工具。根据工具的参数定义,客户端可能会要求你提供收件人、主题、邮件正文等信息。
  4. 发送邮件: 确认信息无误后,指示 LLM 客户端发送邮件。MCP 服务器会调用 Resend API 发送邮件,并将发送结果返回给 LLM 客户端。

信息

分类

通信与社交