Mailgun Docs MCP Server

什么是 Mailgun Docs MCP Server？

Mailgun Docs MCP Server 是 Mailgun 文档站点上一个免费、公开的 MCP 端点，让 AI 编程助手可以搜索 Mailgun 文档并读取其 OpenAPI 定义。它是只读的，无需 API 密钥，也不会发送邮件或触及你的账号。

Mailgun 隶属于 Sinch，是一个用于发送、接收、验证和追踪邮件的邮件 API。借助助手编写 Mailgun 集成时，难点在于把端点路径、参数和区域基础 URL 写对。这个文档服务器依据 Mailgun 自己发布的规范回答这些问题，让助手写出的代码基于最新参考，而不是凭记忆。

如何使用 Mailgun Docs MCP Server？

该服务器托管在 Mailgun 的文档站点上，因此无需安装，也无需配置凭据：

https://documentation.mailgun.com/mcp

它使用 Streamable HTTP。我们的探测以匿名方式连接成功，服务器自称为 “Docs MCP server”。

Claude Code

claude mcp add --transport http mailgun-docs https://documentation.mailgun.com/mcp

Claude Desktop 和 claude.ai

打开 Settings > Connectors，选择 Add custom connector，命名为 “Mailgun Docs”，并粘贴 https://documentation.mailgun.com/mcp。没有登录步骤。

Cursor

在 ~/.cursor/mcp.json 中添加：

{
  "mcpServers": {
    "mailgun-docs": {
      "url": "https://documentation.mailgun.com/mcp"
    }
  }
}

VS Code

在工作区的 .vscode/mcp.json 中添加：

{
  "servers": {
    "mailgun-docs": {
      "type": "http",
      "url": "https://documentation.mailgun.com/mcp"
    }
  }
}

Mailgun Docs MCP Server 的主要功能

• 托管于 documentation.mailgun.com；免费使用，无需 API 密钥、账号或 OAuth。
• 设计上只读：沙箱没有网络访问能力，因此无法调用 Mailgun API 或发送邮件。
• 对 Mailgun 文档页面进行全文搜索。
• 结构化访问已发布的 OpenAPI 定义：Mailgun API、Validations Service、Email Preview API 和 Alerts。
• 端点查询会返回参数、示例、安全要求，以及美国（api.mailgun.net）和欧盟（api.eu.mailgun.net）服务器 URL。
• 采用 “代码模式” 设计：助手把多次查询合并到一个沙箱脚本中，减少往返次数和上下文占用。

Mailgun Docs MCP Server 工具

我们的探测返回了两个 MCP 工具，二者合起来提供一组文档函数：

• describe-tools 返回沙箱函数的精确 TypeScript 签名。助手在运行第一个脚本前调用一次，从而不必猜测参数名。
• execute 在沙箱中运行一段 JavaScript，沙箱唯一的全局对象是 tools。没有 fetch、console 或 Node.js API；所有查询都通过以下函数完成：
  • listApis 列出站点上发布的 API 定义。
  • getEndpoints 列出某个 API 的全部路径和方法。
  • getEndpointInfo 返回单个端点的完整信息，包括参数、示例和安全设置。
  • getSecuritySchemes 和 getFullApiDescription 返回某个 API 的认证方案或完整 OpenAPI 文档。
  • search 搜索文档内容。
  • submitFeedback 报告内容有误或不完整的文档页面。

Mailgun Docs MCP Server 的使用场景

• 编写发送代码：“根据 Mailgun 文档，告诉我发送带附件邮件的端点和必填字段。”
• 确认区域：“托管在 Mailgun 欧盟区域的域名应该使用哪个基础 URL？”
• 邮箱验证：“找到 Validations Service 中验证单个地址的端点，并列出其参数。”
• 认证问题：“Mailgun API 使用哪种认证方案？”
• 在升级前对照最新参考审查现有集成。

Mailgun Docs MCP Server 与替代方案对比

Mailgun 还发布了 Mailgun MCP Server（@mailgun/mcp-server），它使用你的 Mailgun API 密钥在本地运行，执行发送邮件、读取统计、管理域名等真实账号操作。Mailgun 的 MCP 页面说明该服务器仅支持本地运行，不提供托管版本。本页的文档服务器正好相反：托管、免密钥、仅限文档。开发阶段使用文档服务器，需要助手操作你的账号时再使用本地服务器。

Mailgun Docs MCP Server 常见问题排查

• 助手编造函数名： 让它先调用 describe-tools。工具说明要求模型绝不猜测签名。
• 查询返回的 API 版本与预期不同： 多个定义共用同一标题（例如 Validations Service）。结果会在 otherMatches 中列出其他候选；传入 listApis 返回的 filePath 即可选定。
• 脚本内请求 Mailgun 失败： 沙箱无法发起网络请求。请把生成的代码复制到你的项目中，用你自己的密钥运行。