Mailgun MCPサーバー

概要

Mailgun用のModel Context Protocol (MCP) サーバーです。AIエージェントに対して、メール送信、到達性の診断、アカウント操作の管理を行うための実用的でワークフロー指向のインターフェースを提供します。

注: このMCPサーバーはローカルマシン上で実行されます。Mailgunは現在、このサーバーのホスト版を提供していません。

機能

• メッセージング — メールの送信、保存済みメッセージの取得、メッセージの再送

• ドメイン — ドメイン詳細の表示、DNS設定の検証、トラッキング設定（クリック、開封、登録解除）の管理

• Webhook — イベントWebhookの一覧表示、作成、更新、削除

• ルート — インバウンドメールのルーティングルールの表示と更新

• メーリングリスト — メーリングリストとそのメンバーの作成と管理

• テンプレート — バージョン管理付きのメールテンプレートの作成と管理

• 分析 — 送信メトリクス、使用量メトリクス、ログのクエリ

• 統計 — ドメイン、タグ、プロバイダー、デバイス、国別の集計統計の表示

• 抑制リスト — バウンス、登録解除、苦情、許可リストエントリの表示

• IPおよびIPプール — IP割り当てと専用IPプールの設定の表示

• バウンス分類 — バウンスタイプと配信の問題の分析

Related MCP server: Enhanced Gmail MCP Server

前提条件

• 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"
      }
    }
  }
}

環境変数

クライアント固有の設定パス

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json

• Claude Desktop (Windows): %APPDATA%/Claude/claude_desktop_config.json

• Claude Code: 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とのすべての通信は、TLS証明書の検証が強制されたHTTPS経由で行われます。Mailgun API以外のサードパーティサービスにデータが送信されることはありません。

APIキーの権限

必要な操作のみにスコープを絞った権限を持つ、専用のMailgun APIキーを使用してください。サーバーは読み取りおよび更新操作を公開しますが、削除操作は公開しないため、意図しないアクションによる影響範囲を制限しています。

レート制限

サーバーはクライアント側のレート制限を実装していません。AIからの各ツール呼び出しは、直接Mailgun APIリクエストに変換されます。サーバーは悪用を防ぐためにMailgunのサーバー側レート制限に依存しており、制限を超えたリクエストはAIアシスタントにエラーを返します。

プロンプトインジェクション

他のMCPサーバーと同様に、巧妙に作成された悪意のあるプロンプトによって、AIアシスタントが意図しない操作（トラッキング設定の変更やメーリングリストメンバーの読み取りなど）を行うように誘導される可能性があります。特に信頼できないプロンプトコンテキストでは、アクションを承認する前にAIアシスタントのツール呼び出しの確認内容をレビューしてください。

Webhook URL

Webhookの作成および更新操作は、AIアシスタントを通じて提供される任意のURLを受け入れます。MCPサーバーは、追加の検証なしでこれらのURLをMailgun APIに渡します。Webhookの宛先を検証するのはMailgunの責任です。AIアシスタントが意図しない内部アドレスや機密アドレスにWebhook URLを設定しないようにしてください。

入力検証

すべてのツールパラメータは、Zodスキーマを使用してMailgun OpenAPI仕様に対して検証されます。ただし、検証はOpenAPI仕様の正確性に依存しており、一部のエッジケースのパラメータは寛容な検証にフォールバックする場合があります。Mailgun APIは、保護の追加レイヤーとして独自のサーバー側検証を実行します。

デバッグ

MCPサーバーはstdio経由で通信します。トラブルシューティングについては、MCPデバッグガイドを参照してください。

ライセンス

Apache 2.0 — 詳細はLICENSEを参照してください。

貢献

貢献を歓迎します！プルリクエストの送信やIssueの作成を自由に行ってください。