使用说明

项目简介

Email sending server 是一个基于 Model Context Protocol (MCP) 构建的简单服务器,旨在让大型语言模型 (LLM) 客户端(如 Cursor 或 Claude)能够直接发送电子邮件。它利用 Resend API 服务,使得用户可以通过 LLM 方便地撰写和发送邮件,无需手动复制粘贴邮件内容到邮件客户端。

主要功能点

  • 邮件发送: 通过集成 Resend API,提供可靠的邮件发送功能。
  • LLM 客户端集成: 设计为 MCP 服务器,可以与支持 MCP 协议的 LLM 客户端(如 Cursor, Claude Desktop)无缝集成。
  • 灵活配置: 支持通过命令行参数或环境变量配置 Resend API 密钥、发件人邮箱和回复邮箱等信息。
  • 简单的工具接口: 提供 'send-email' 工具,LLM 客户端可以通过调用此工具发送邮件。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。
  2. 克隆仓库: 将 GitHub 仓库 'https://github.com/ykhli/mcp-send-email' 克隆到本地。
    git clone https://github.com/ykhli/mcp-send-email
    cd mcp-send-email
  3. 安装依赖: 在项目根目录下运行以下命令安装项目依赖。
    npm install
  4. 构建项目: 运行以下命令构建项目,生成可执行的 JavaScript 文件。
    npm run build
    构建成功后,会在 'build' 目录下生成 'index.js' 文件,这就是 MCP 服务器的脚本。
  5. 配置 Resend API 密钥: 你需要从 Resend 官网 获取 API 密钥。

服务器配置

对于 Cursor 客户端:

在 Cursor 设置中,选择 "MCP" -> "Add new MCP server",然后按照以下信息配置:

  • Name: 自定义服务器名称,例如 'email-sender'

  • Type: 选择 'command'

  • Command: 填写启动服务器的命令,需要替换为 'index.js' 文件的绝对路径和你的 Resend API 密钥。

    node ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js --key=YOUR_RESEND_API_KEY --sender=发件人邮箱地址(可选) --reply-to=回复邮箱地址1(可选) --reply-to=回复邮箱地址2(可选)

    参数说明:

    • 'ABSOLUTE_PATH_TO_MCP_SERVER': 替换为 'build/index.js' 文件的绝对路径,例如 '/Users/yourname/mcp-send-email/build/index.js'
    • '--key=YOUR_RESEND_API_KEY': 必填,替换为你的 Resend API 密钥。
    • '--sender=发件人邮箱地址(可选)': 可选,设置默认的发件人邮箱地址。如果设置,则发送邮件时无需每次都指定发件人。
    • '--reply-to=回复邮箱地址(可选)': 可选,设置默认的回复邮箱地址。可以多次使用 '--reply-to' 指定多个回复邮箱。

对于 Claude Desktop 客户端:

在 Claude Desktop 的 MCP 配置中,添加以下 JSON 配置:

{
  "mcpServers": {
    "resend": {  // 服务器名称,可以自定义
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"], // 替换为 index.js 文件的绝对路径
      "env": {
        "RESEND_API_KEY": "YOUR_API_KEY", // 替换为你的 Resend API 密钥
        "SENDER_EMAIL_ADDRESS": "发件人邮箱地址(可选)", // 可选,设置默认发件人邮箱
        "REPLY_TO_EMAIL_ADDRESSES": "回复邮箱地址1,回复邮箱地址2(可选)" // 可选,设置默认回复邮箱,多个邮箱用逗号分隔
      }
    }
  }
}

配置说明:

  • '"resend"': 服务器名称,可以自定义。
  • '"command": "node"': 启动命令为 'node'。
  • '"args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"]': 'args' 数组包含 'index.js' 文件的绝对路径,例如 '"/Users/yourname/mcp-send-email/build/index.js"'。
  • '"env"': 环境变量配置。
    • '"RESEND_API_KEY"': 必填,你的 Resend API 密钥。
    • '"SENDER_EMAIL_ADDRESS"': 可选,默认发件人邮箱地址。
    • '"REPLY_TO_EMAIL_ADDRESSES"': 可选,默认回复邮箱地址,多个邮箱地址用逗号分隔。

基本使用方法

  1. 启动 MCP 服务器: 根据 Cursor 或 Claude 的配置方式启动 MCP 服务器。
  2. 在 LLM 客户端中使用:
    • 在 Cursor 中,可以创建一个 'email.md' 文件,填写邮件内容,然后选中邮件内容,使用 'cmd+l' 快捷键,在聊天框中输入指令 "send this as an email" 并发送。
    • 在 Claude Desktop 中,可以使用类似的指令,例如 "Use the 'send-email' tool to send this email..."。具体指令取决于 LLM 客户端的工具调用方式。
    • 确保 LLM 客户端处于 Agent 模式,以便其可以调用 MCP 服务器提供的工具。
  3. 发送邮件: LLM 客户端会调用 'send-email' 工具,你需要根据工具的参数提示(例如收件人邮箱、邮件主题等)提供必要的信息。如果服务器配置中没有提供默认的发件人或回复邮箱,LLM 可能会要求你提供这些信息。

信息

分类

通信与社交