返回 MCP 目录
public公开dns本地运行

mailgun-mcp-server

Mailgun的MCP服务器实现,支持AI客户端通过MCP协议与Mailgun服务交互

article

README

🚀 邮件枪MCP服务器

这是一个为邮件枪实现的模型上下文协议(MCP)服务器,能让兼容MCP的AI客户端(如Claude Desktop)与该服务进行交互。

🚀 快速开始

手动安装

  1. 克隆仓库:

    git clone https://github.com/mailgun/mailgun-mcp-server.git
    cd mailgun-mcp-server
    
  2. 安装依赖项并构建:

    npm install
    
  3. 配置Claude Desktop:

    创建或修改配置文件:

    • MacOS:~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows:%APPDATA%/Claude/claude_desktop_config.json

    添加以下配置:

    {
        "mcpServers": {
            "mailgun": {
                "command": "node",
                "args": ["CHANGE/THIS/PATH/TO/mailgun-mcp-server/src/mailgun-mcp.js"],
                "env": {
                    "MAILGUN_API_KEY": "YOUR-mailgun-api-key"
                }
            }
        }
    }
    

测试

运行本地测试套件:

NODE_ENV=test npm test

示例提示与Claude交互

发送电子邮件

⚠️ 重要提示

截至2025-03-18,发送电子邮件似乎需要具有Anthropic付费账户。使用免费账户会导致静默失败。

你能发送一封电子邮件到EMAIL_HERE,并附上有趣的内容,使其看起来像是来自《办公室》中的IT部门吗?
请使用发送域DOMAIN_HERE,并从"postmaster@DOMAIN_HERE"发送!

拉取并可视化发送统计信息

你能生成一张过去一周的电子邮件投递统计数据图表吗?

调试

MCP服务器通过stdio通信,请参考调试部分获取详细信息。

📦 安装指南

先决条件

  • Node.js(v18或更高版本)
  • Git
  • Claude Desktop(用于Claude集成)
  • 邮件枪账户及API密钥

📄 许可证

请查看LICENSE文件以了解详细信息

💡 贡献

我们欢迎任何贡献!请随意提交Pull Request。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端