Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client