Mailgun MCP服务器
概述
A. 模型上下文协议 （MCP）服务器 Mailgun 这为AI代理提供了一个实用的、面向工作流的界面，用于发送电子邮件、诊断可送达性和管理帐户操作。
注： 此MCP服务器在您的计算机上本地运行。Mailgun目前不提供此服务器的托管版本。
能力
- 消息传递 --发送电子邮件、检索存储的消息、重新发送消息
- 领域 --查看域详细信息，验证DNS配置，管理跟踪设置（单击、打开、取消订阅）
- 网络钩子 --列出、创建、更新和删除事件webhooks
- 路线 --查看和更新入站电子邮件路由规则
- 邮件列表 --创建和管理邮件列表及其成员
- 模板 --使用版本控制创建和管理电子邮件模板
- 分析 --查询发送指标、使用指标和日志
- 统计 --按域、标签、提供商、设备和国家查看聚合统计信息
- 抑制 --查看跳出、取消订阅、投诉和允许的条目
- IP和IP池 --查看IP分配和专用IP池配置
- 弹跳分类 --分析退货类型和交货问题
先决条件
- Node.js（v20.12或更高版本）
- Mailgun帐户和API密钥
快速开始
配置
将以下内容添加到MCP客户端配置中：
{
"mcpServers": {
"mailgun": {
"command": "npx",
"args": ["-y", "@mailgun/mcp-server"],
"env": {
"MAILGUN_API_KEY": "YOUR-mailgun-api-key",
"MAILGUN_API_REGION": "us"
}
}
}
}环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
MAILGUN_API_KEY | 是 | - | 您的Mailgun API密钥 |
MAILGUN_API_REGION | 没有 | us | API地区： us 或 eu |
客户端特定的配置路径
- 克劳德桌面版 （macOS）：
~/Library/Application Support/Claude/claude_desktop_config.json - 克劳德桌面版 （Windows）：
%APPDATA%/Claude/claude_desktop_config.json - 克劳德代码：运行
claude mcp add或编辑~/.claude.json
示例提示
发送电子邮件
Can you send an email to EMAIL_HERE with a funny email body that makes it sound
like it's from the IT Desk from Office Space? Please use the sending domain
DOMAIN_HERE, and make the email from "postmaster@DOMAIN_HERE"!注意：一些MCP客户端需要付费计划来调用发送数据的工具。如果发送无声失败，请检查客户的计划。
获取并可视化发送统计信息
Would you be able to make a chart with email delivery statistics for the past week?管理模板
Create a welcome email template for new signups on my domain DOMAIN_HERE.
Include a personalized greeting and a call-to-action button.调查交付能力
Can you check the bounce classification stats for my account and tell me
what the most common bounce reasons are?DNS故障排除
Check the DNS verification status for my domain DOMAIN_HERE and tell me
if anything needs fixing.审查抑制
Are there any unsubscribes or complaints for DOMAIN_HERE? Summarize the
top offenders.管理路由规则
List all my inbound routes and explain what each one does.创建邮件列表
Create a mailing list called announcements@DOMAIN_HERE and add these
members: alice@example.com, bob@example.com.比较域名
Compare my sending volume and delivery rates across all my domains for
the past month.按地区划分的参与度
Break down my email engagement by country and device for DOMAIN_HERE.查看跟踪设置
List all my domains and show which ones have tracking enabled for clicks
and opens.发展
要从源代码运行，请克隆存储库并使用 node 直接：
git clone https://github.com/mailgun/mailgun-mcp-server.git
cd mailgun-mcp-server
npm install
npm test在MCP客户端配置中，替换 npx 命令：
"command": "node",
"args": ["/path/to/mailgun-mcp-server/src/mailgun-mcp.js"]安全考虑
API密钥隔离
您的Mailgun API密钥是作为环境变量传递的，并且永远不会暴露给AI模型本身——它仅由MCP服务器进程用于验证请求。服务器不记录API密钥、请求参数或响应数据。
本地执行
服务器在您的计算机上本地运行。与Mailgun API的所有通信都通过HTTPS进行，并强制执行TLS证书验证。除了Mailgun API之外，不会向第三方服务发送任何数据。
API密钥权限
使用专门的Mailgun API密钥，其权限范围仅限于您需要的操作。服务器公开读取和更新操作，但不公开任何删除操作，这限制了意外操作的爆炸半径。
速率限制
服务器未实现客户端速率限制。来自AI的每个工具调用都直接转换为Mailgun API请求。服务器依赖Mailgun的服务器端速率限制来防止滥用——超过这些限制的请求将向AI助手返回错误。
快速注射
与任何MCP服务器一样，精心设计的或对抗性的提示可能会诱使AI助手调用您不打算调用的操作，例如修改跟踪设置或读取邮件列表成员。在批准操作之前，请查看人工智能助手的工具调用确认，特别是在不受信任的提示上下文中。
Webhook URL
Webhook创建和更新操作接受通过AI助手提供的任意URL。MCP服务器将这些URL传递给Mailgun API，而无需额外验证。Mailgun负责验证webhook目标。确保您的AI助手不会将webhook URL设置为意外的内部或敏感地址。
输入验证
所有工具参数都使用Zod模式根据Mailgun OpenAPI规范进行验证。然而，验证取决于OpenAPI规范的准确性，一些边缘情况参数可能会退回到许可验证。Mailgun API执行自己的服务器端验证，作为额外的保护层。
调试
MCP服务器通过stdio进行通信。参见 MCP调试指南 用于故障排除。
许可证
Apache 2.0——请参阅 许可证 了解详情。