项目简介
本项目是一个基于 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 客户端的兼容性,可以方便地集成到这些工具中使用。
安装步骤
- 安装 Node.js 和 npm: 确保你的电脑上已安装 Node.js 和 npm (Node 包管理器)。
- 克隆仓库: 将 'mcp-send-email' 仓库克隆到本地:
git clone https://github.com/resend/mcp-send-email.git cd mcp-send-email - 安装依赖: 在项目根目录下运行以下命令安装项目依赖:
npm install - 构建项目: 运行以下命令编译 TypeScript 代码:
构建成功后,会在 'build' 目录下生成 'index.js' 文件,这是 MCP 服务器的入口文件。npm run build - 获取 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 客户端都会要求用户提供发件人邮箱。 } } } }
基本使用方法
- 启动 MCP 服务器: 在终端中,进入项目根目录,运行配置好的 Cursor 或 Claude Desktop 命令,启动 MCP 服务器。例如,如果配置中 'command' 为 'node', 'args' 为 'ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js --key=YOUR_RESEND_API_KEY',则直接运行该命令即可。
- 在 LLM 客户端中使用: 在 Cursor 或 Claude Desktop 中,可以使用自然语言指令 (例如 "发送邮件给 xxx,主题是 xxx,内容是 xxx") 或通过选择邮件内容并使用快捷键 (如 Cursor 的 'cmd+l') 来触发邮件发送工具。
- 调用 'send-email' 工具: LLM 客户端会识别邮件发送意图,并调用 'send-email' 工具。根据工具的参数定义,客户端可能会要求你提供收件人、主题、邮件正文等信息。
- 发送邮件: 确认信息无误后,指示 LLM 客户端发送邮件。MCP 服务器会调用 Resend API 发送邮件,并将发送结果返回给 LLM 客户端。
信息
分类
通信与社交