mcpField
M
mcp-mailtrap

mcp-mailtrap

ローカル
github.com/pijuszコミュニケーション36 日前に更新

mcp-mailtrap について

mcp-mailtrapは、メール配信、連絡先、テストを管理するチーム向けに、Mailtrapの操作をMCPクライアントへ接続します。分析、送信、テンプレート、アカウント管理、サンドボックス受信箱の確認に対応します。

主な機能

  1. 01配信とエンゲージメントの分析
  2. 02トランザクションメールと一括メールの送信
  3. 03テンプレートと連絡先の管理
  4. 04サンドボックスのメールとスパム分析の確認
  5. 05ドメイン、アカウント、トークンの管理

活用シーン

  1. 01配信とエンゲージメントの傾向を調査
  2. 02メールの送信やテスト
  3. 03連絡先リストとテンプレートの更新
  4. 04配信前にサンドボックスのメールを確認

MCP 対応

Mailtrapの分析、メール送信、連絡先、テンプレート、サンドボックス、ドメイン、アカウント操作をMCPクライアント向けツールとして提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"pijusz-mcp-mailtrap": {
"command": "npx",
"args": [
"-y",
"mcpj-mailtrap"
]
}
}
}
起動コマンドnpx -y mcpj-mailtrap

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmmcpj-mailtrap0.1.4

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

mcpj-mailtrap

mcpj-mailtrap

Mailtrap MCP サーバー — 自然言語で分析、メールログ、連絡先、サンドボックステストなどを利用できます。
Bun + TypeScript で構築されています。Claude、Cursor、およびあらゆる MCP クライアントで動作します。


クイックスタート

1. API トークンを取得する

Mailtrap API Tokensから API トークンを取得します。

2. Claude Code に追加する

最小構成

claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- npx mcpj-mailtrap

完全な構成

claude mcp add mailtrap \
  -e MAILTRAP_API_TOKEN=your_token \
  -e MAILTRAP_SENDING_TOKEN=your_sending_token \
  -e MAILTRAP_ACCOUNT_ID=12345 \
  -e [email protected] \
  -e MAILTRAP_TEST_INBOX_ID=12345 \
  -- npx mcpj-mailtrap

これで完了です。Claude Code を再起動すると、ツールを利用できます。

Bunがあれば、bunx mcpj-mailtrap@latestでも動作します。 npxで実行する場合は Node 18 以降が必要です。

Claude Desktop / Cursor

最小構成

{
  "mcpServers": {
    "mailtrap": {
      "command": "npx",
      "args": ["-y", "mcpj-mailtrap@latest"],
      "env": {
        "MAILTRAP_API_TOKEN": "your_token"
      }
    }
  }
}

完全な構成

{
  "mcpServers": {
    "mailtrap": {
      "command": "npx",
      "args": ["-y", "mcpj-mailtrap@latest"],
      "env": {
        "MAILTRAP_API_TOKEN": "your_token",
        "MAILTRAP_SENDING_TOKEN": "your_sending_token",
        "MAILTRAP_ACCOUNT_ID": "12345",
        "MAILTRAP_DEFAULT_FROM_EMAIL": "[email protected]",
        "MAILTRAP_TEST_INBOX_ID": "12345"
      }
    }
  }
}
別の方法:スタンドアロンバイナリ

Releasesからビルド済みバイナリをダウンロードします。

プラットフォームファイル
macOS(Apple Silicon)mcpj-mailtrap-darwin-arm64
macOS(Intel)mcpj-mailtrap-darwin-x64
Linuxmcpj-mailtrap-linux-x64
Windowsmcpj-mailtrap-windows-x64.exe

macOS / Linux:

curl -Lo mcpj-mailtrap https://github.com/pijusz/mcp-mailtrap/releases/latest/download/mcpj-mailtrap-darwin-arm64
chmod +x mcpj-mailtrap
sudo mv mcpj-mailtrap /usr/local/bin/
claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- /usr/local/bin/mcpj-mailtrap

Windows(PowerShell):

Invoke-WebRequest -Uri "https://github.com/pijusz/mcp-mailtrap/releases/latest/download/mcpj-mailtrap-windows-x64.exe" -OutFile "$env:LOCALAPPDATA\mcpj-mailtrap.exe"
claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- "%LOCALAPPDATA%\mcpj-mailtrap.exe"

ツール(46)

分析
ツール説明
get_stats送信統計 — 配信率、バウンス率、開封率、クリック率、迷惑メール率。ドメイン、カテゴリ、ESP、日付でグループ化できます
メールログ
ツール説明
get_email_logsステータス、ストリーム、日付範囲、受信者、送信者、件名、カテゴリで絞り込んで送信済みメールを一覧表示します。カーソルベースのページネーションに対応しています
get_email_log配信イベントのタイムラインを含む、単一メッセージの詳細
get_suppressions抑制対象のメール(バウンス、迷惑メールの苦情、配信停止)を一覧表示します。delete_suppressionで必要となる ID も取得できます
delete_suppression抑制対象のアドレスへの送信を再度有効にします
check_list_hygiene連絡先リストに残っている抑制対象のメールを見つけ、具体的なクリーンアップ方法を提案します
送信
ツール説明
send_emailトランザクションストリームまたは一括送信ストリームで送信します。HTML、テキスト、テンプレートに対応しています
batch_send1 回のリクエストで最大 500 件のメールを送信します
send_test_emailテスト用にサンドボックスの受信トレイへ送信します。受信トレイと送信者の環境変数による既定値を任意で指定できます
テンプレート
ツール説明
list_templatesすべてのメールテンプレートを一覧表示します
get_templateHTML/テキスト本文を含むテンプレートの詳細を取得します
create_template新しいテンプレートを作成します
update_template既存のテンプレートを更新します
delete_templateテンプレートを削除します
render_react_emailreact-email コンポーネントファイル(.tsx、.jsx、.js、.mjs)を HTML とプレーンテキストに変換します
連絡先
ツール説明
create_contactメールアドレス、カスタムフィールド、リストへの登録を指定して連絡先を作成します
get_contactUUID またはメールアドレスで連絡先を取得します
update_contact連絡先のフィールド、リストへの登録、購読ステータスを更新します
delete_contact連絡先を削除します
trigger_contact_event連絡先のオートメーションを実行します
list_contact_listsすべての連絡先リストを一覧表示します
get_contact_list単一の連絡先リストを取得します
create_contact_list新しい連絡先リストを作成します
update_contact_list連絡先リストの名前を変更します
delete_contact_list連絡先リストを削除します
manage_contact_fieldカスタム連絡先フィールドを一覧表示、取得、作成、更新、削除します
import_contacts最大 5 万件の連絡先を一括インポートするか、インポートのステータスを確認します
export_contacts連絡先のエクスポートを開始するか、エクスポートのステータスを確認します
メールサンドボックス
ツール説明
list_projects受信トレイを含むサンドボックスプロジェクトを一覧表示します
get_project単一のプロジェクトを取得します
manage_projectプロジェクトを作成、更新、または削除します
list_inboxesすべてのサンドボックス受信トレイを一覧表示します
get_inbox受信トレイの詳細を取得します(認証情報はデフォルトで非表示)
manage_inbox作成、更新、クリア、既読にする、認証情報のリセット、または削除を行います
get_messagesサンドボックス受信トレイ内のメッセージを一覧表示します
get_message添付ファイルの取得を指定して、HTML/テキスト/raw/EML形式のメッセージ本文を取得します
analyze_messageスパムスコア、HTML分析、ヘッダーレポートをまとめて取得します
forward_messageテストメッセージをメールアドレスに転送します
ドメイン
ツール説明
list_domainsDNSステータスとともに送信ドメインを一覧表示します
get_domainDNSレコードを含むドメインの詳細を取得します
manage_domain送信ドメインを作成または削除します
send_domain_setup_instructionsDNS設定手順を同僚にメールで送信します
アカウント
ツール説明
list_accountsアカウントを一覧表示するか、IDで1つ取得します
get_billing_usageプランの上限と現在の使用量を取得します
manage_account_accessリソースの一覧表示、削除、権限の更新、確認を行います
manage_api_tokenAPIトークンの一覧表示、取得、作成、削除、リセットを行います

設定

変数必須デフォルト説明
MAILTRAP_API_TOKENはい—mailtrap.io/api-tokensから取得した一般的なAPIトークン
MAILTRAP_SENDING_TOKENいいえMAILTRAP_API_TOKENトランザクションメールと一括送信のsend.apiリクエスト用の別トークン
MAILTRAP_ACCOUNT_IDいいえ自動検出デフォルトのアカウントID
MAILTRAP_DEFAULT_FROM_EMAILいいえ—send_email/send_test_emailのデフォルトの送信者メールアドレス
MAILTRAP_TEST_INBOX_IDいいえ—send_test_emailのデフォルトのサンドボックス受信トレイID
DEBUGいいえ—デバッグログを有効にします

更新

npx @latestを使用する場合(推奨):常に最新バージョンを使用でき、手動で更新する必要はありません。

バイナリを使用する場合:サーバーは起動時に新しいリリースを確認し、古いバージョンの場合はstderrにログを出力します。

[mcpj-mailtrap] Update available: v0.2.0 (current: v0.1.0)

インストール済みのバージョンを確認します。

mcpj-mailtrap --version

開発

Bunが必要です。

git clone https://github.com/pijusz/mcp-mailtrap.git
cd mcp-mailtrap
bun install
bun test           # tests
bun run typecheck  # tsc
bun run build      # standalone binary
bun run inspect    # MCP Inspector
bun run check      # biome format + lint

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。