使用说明
项目简介
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 客户端可以通过调用此工具发送邮件。
安装步骤
- 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。
- 克隆仓库: 将 GitHub 仓库 'https://github.com/ykhli/mcp-send-email' 克隆到本地。
git clone https://github.com/ykhli/mcp-send-email cd mcp-send-email - 安装依赖: 在项目根目录下运行以下命令安装项目依赖。
npm install - 构建项目: 运行以下命令构建项目,生成可执行的 JavaScript 文件。
构建成功后,会在 'build' 目录下生成 'index.js' 文件,这就是 MCP 服务器的脚本。npm run build - 配置 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"': 可选,默认回复邮箱地址,多个邮箱地址用逗号分隔。
基本使用方法
- 启动 MCP 服务器: 根据 Cursor 或 Claude 的配置方式启动 MCP 服务器。
- 在 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 服务器提供的工具。
- 发送邮件: LLM 客户端会调用 'send-email' 工具,你需要根据工具的参数提示(例如收件人邮箱、邮件主题等)提供必要的信息。如果服务器配置中没有提供默认的发件人或回复邮箱,LLM 可能会要求你提供这些信息。
信息
分类
通信与社交