MCP发送电子邮件
MCP(Model Context Protocol)服务器,用于使用重新发送服务发送电子邮件。该项目允许将电子邮件发送功能集成到使用MCP协议的应用程序中。
描述
这个MCP服务器提供了一个工具(send_emails)允许使用发送API向多个收件人发送电子邮件。服务器通过STDIO协议通信,可以与Claude Desktop等MCP客户端集成。
特点
- 向多个收件人发送电子邮件
- 电子邮件地址验证
- 支持邮件正文中的HTML内容
- 鲁棒错误处理
- 使用MCP(模型上下文协议)的通信
- 用TypeScript实现,以提高类型的安全性
先决条件
- Node.js(推荐版本16或更高)
- npm o纱线
- 的API密钥 重发
安装
- 克隆存储库:
git clone
cd mcp-send-emails- 安装依赖项:
npm install- 配置环境变量
RESEND_API_KEY使用您的重新发送API密钥:
# En Windows (PowerShell)
$env:RESEND_API_KEY="tu_api_key_aquí"
# En Windows (CMD)
set RESEND_API_KEY=tu_api_key_aquí
# En Linux/Mac
export RESEND_API_KEY="tu_api_key_aquí"或创建文件 .env 在项目的根源上:
RESEND_API_KEY=tu_api_key_aquí- 汇编项目:
npm run build使用
在开发模式下运行:
npm start在生产模式下运行:
npm run build
node build/index.js作为二进制:
编译后,您可以直接运行服务器:
npx mcp-send-emails项目结构
mcp-send-emails/
├── src/
│ ├── index.ts # Punto de entrada del servidor MCP
│ └── services/
│ └── email.ts # Servicio de envío de emails con Resend
├── build/ # Archivos compilados (generados)
├── node_modules/ # Dependencias (no incluidas en git)
├── package.json # Configuración del proyecto y dependencias
├── tsconfig.json # Configuración de TypeScript
├── .gitignore # Archivos ignorados por git
└── README.md # Este archivo服务器API
工具: send_emails
向收件人列表发送电子邮件。
参数:
| 参数 | 类型 | 描述 |
|---|---|---|
to | string[] | 收件人电子邮件地址列表(已验证) |
subject | string | 电子邮件主题 |
body | string | 电子邮件正文内容(支持HTML) |
成功答案:
{
"content": [
{
"type": "text",
"text": "Email sent successfully to: ejemplo@email.com with subject: \"Tu Asunto\" email with id abc123 Code:2"
}
]
}错误响应:
{
"content": [
{
"type": "text",
"text": "Failed to send email to: ejemplo@email.com. Error: [mensaje de error] Code:1"
}
]
}与Claude Desktop的集成
要将此服务器与Claude Desktop一起使用,请将以下设置添加到您的Claude配置文件中:
En Windows: %APPDATA%\Claude\claude_desktop_config.json 英语Mac/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"send-emails": {
"command": "node",
"args": [
"C:\\ruta\\completa\\a\\mcp-send-emails\\build\\index.js"
],
"env": {
"RESEND_API_KEY": "tu_api_key_aquí"
}
}
}
}添加设置后,重新启动Claude Desktop。
主要单位
生产:
- @模型上下文协议/sdk (^1.21.0):用于部署 MCP 服务器的官方 SDK
- 重发 (^6.4.1):电子邮件转发API的官方客户
- 黄道带 (^ 3.25.76):架构和类型验证库
发展:
- TypeScript (^ 5.9.3):JavaScript类型的超级集
- TSX (^4.20.6):用于开发的TypeScript执行器
- @类型/节点 (^24.10.0):Node.js的类型定义
可用脚本
| 脚本 | 描述 |
|---|---|
npm run build | 将TypeScript代码编译为JavaScript |
npm start | 使用TSX以开发模式运行服务器 |
npm run prepare | 之后自动运行的钩子 npm install |
使用的技术
- TypeScript:带有静态类型的主语言
- Node.js:执行环境
- MCP(模型上下文协议):与AI模型的通信协议
- 重发:电子邮件发送服务
- 黄道:模式验证和分析
配置类型脚本
该项目配置为:
- 目标:ES2022
- 模块:Node16
- 严格模式激活
- ESM(ECMAScript模块)
- 输出到文件夹
build/
安全
- Resend的Key API必须保持安全,并且永远不应提交到存储库
- 档案馆
.env包括在.gitignore防止意外暴露证书 - 电子邮件地址在发送前由Zod验证
当前的限制
- 发件人(
from)被硬编码为onboarding@resend.dev - 要使用自定义发件人地址,您需要验证发送中的域
- 电子邮件内容仅支持HTML格式
贡献
为该项目做出贡献:
- 叉库
- 为您的功能创建分支(
git checkout -b feature/nueva-funcionalidad) - 提交您的更改(
git commit -am 'Agregar nueva funcionalidad') - 推拉拉马(
git push origin feature/nueva-funcionalidad) - Crea取消拉取请求
作者
亚当斯孔特雷拉斯
许可证
国际协调委员会
额外资源
故障排除
错误:“Resend_API_Key未定义”
- 确保您已经配置了环境变量
RESEND_API_KEY - 验证文件
.env在项目的根目录中(如果您正在使用它)
错误:“找不到模块”
- 执行
npm install安装所有依赖项 - 验证项目是用
npm run build
电子邮件未发送
- 验证您的重新发送密钥API是否有效
- 确认电子邮件地址有效
- 检查错误日志以了解更多细节
