@共振/面纱mcp
A. 模型上下文协议（MCP） 公开Veil Mail API操作作为人工智能代理工具的服务器。这允许像Claude、ChatGPT、Cursor和其他MCP兼容客户端这样的人工智能助手发送电子邮件、管理模板、与受众合作，并通过自然语言检索分析。
Veil Mail是唯一一个拥有一流MCP服务器的电子邮件API。 Resend、SendGrid、Mailgun和Postmark不提供MCP集成——将它们连接到Claude或Cursor需要手工构建服务器。这艘船作为 npx @resonia/veilmail-mcp 只需一个配置条目，即可直接进入Claude Desktop或任何MCP客户端。涵盖电子邮件、域名、模板、受众、活动和分析的十种工具。 相关： · 完整的MCP文档 · AI助手集成指南安装
npm install @resonia/veilmail-mcp或者直接使用npx运行：
npx @resonia/veilmail-mcp配置
服务器需要Veil Mail API密钥来验证请求。通过设置 VEILMAIL_API_KEY 环境变量。
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
VEILMAIL_API_KEY | 是 | - | 您的Veil Mail API密钥（例如。， veil_live_xxxxx) |
VEILMAIL_BASE_URL | 没有 | https://api.veilmail.xyz | 自定义API基本URL（适用于自托管实例） |
您可以从获取API密钥 面纱邮件仪表板.
使用Claude Desktop
将以下内容添加到您的 claude_desktop_config.json:
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"veilmail": {
"command": "npx",
"args": ["@resonia/veilmail-mcp"],
"env": {
"VEILMAIL_API_KEY": "veil_live_xxxxx"
}
}
}
}更新配置后重新启动Claude Desktop。您应该在工具菜单中看到可用的面纱邮件工具。
与其他MCP客户端一起使用
任何兼容MCP的客户端都可以使用此服务器。将其作为通过stdio进行通信的子进程启动：
VEILMAIL_API_KEY=veil_live_xxxxx npx @resonia/veilmail-mcp可用工具
send_邮件
通过Veil Mail发送电子邮件。支持HTML内容、模板、附件和日程安排。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
from | string | 是 | 发件人电子邮件地址（必须来自已验证的域） |
to | string | 是 | 收件人电子邮件地址 |
subject | string | 是 | 电子邮件主题行 |
html | string | 否 | 电子邮件的HTML内容 |
text | string | 否 | 纯文本回退内容 |
templateId | string | 否 | 要代替html/text使用的模板ID |
templateData | object | 否 | 要填充模板变量的数据 |
cc | string | 否 | 抄送收件人电子邮件地址 |
bcc | string | 否 | 密件抄送收件人电子邮件地址 |
replyTo | string | 否 | 回复电子邮件地址 |
scheduledFor | string | 否 | 用于安排电子邮件的ISO 8601日期时间 |
get_email
通过ID获取已发送电子邮件的详细信息。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | 是 | 电子邮件ID |
list_邮件
使用可选过滤器列出已发送的电子邮件。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
limit | number | 否 | 要返回的电子邮件数量（最多100封） |
status | string | 否 | 按状态筛选：排队、已发送、已送达、已退回、失败 |
validate_email
验证电子邮件地址。检查语法、MX记录、可丢弃域和角色地址。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
email | string | 是 | 要验证的电子邮件地址 |
list_templates
列出可用的电子邮件模板。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
limit | number | 否 | 要返回的模板数 |
get_template
按ID获取特定的电子邮件模板。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | 是 | 模板ID |
list_domains
列出已验证的发送域。无需参数。
列表_观众
列出电子邮件受众/联系人列表。无需参数。
add_订阅者
向受众添加订阅者。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
audienceId | string | 是 | 要将订阅者添加到的受众ID |
email | string | 是 | 订阅者电子邮件地址 |
firstName | string | 否 | 订阅者名字 |
lastName | string | 否 | 订阅者姓氏 |
get_analytics
获取电子邮件分析概述，包括投递率、打开次数、点击次数和退回次数。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
days | number | 否 | 回顾天数（默认值：30） |
交互示例
配置后，您可以向AI助手询问以下问题：
- “发送欢迎电子邮件至user@example.com从hello@mydomain.com"
- “列出我的所有电子邮件模板”
- “显示过去7天的电子邮件分析”
- “验证电子邮件地址test@example.com"
- “添加john@example.com致我的时事通讯读者”
- “我最近的电子邮件的投递率是多少？”
安全考虑
- 切勿在提示或对话历史记录中公开API密钥。 始终使用环境变量。
- 使用测试模式键(
veil_test_xxxxx)在开发过程中 避免发送真实的电子邮件。 - 发送前检查电子邮件内容。 AI助手将使用
send_email工具，因此请验证收件人地址和内容是否正确。 - 适当地范围API键。 创建专门的API密钥供MCP使用，只需具有所需的权限。
- 定期旋转按键。 如果您怀疑API密钥已被泄露，请立即在Veil Mail仪表板中旋转它。
发展
# Clone the repository
git clone https://github.com/resonia/veil-mail.git
cd veil-mail/packages/mcp-server
# Install dependencies
bun install
# Build
bun run build
# Run locally
VEILMAIL_API_KEY=veil_test_xxxxx node dist/index.js
# Type check
bun run typecheck
# Watch mode
bun run dev许可证
麻省理工学院