mcp-mailtrap について
mcp-mailtrapは、メール配信、連絡先、テストを管理するチーム向けに、Mailtrapの操作をMCPクライアントへ接続します。分析、送信、テンプレート、アカウント管理、サンドボックス受信箱の確認に対応します。
主な機能
- 01配信とエンゲージメントの分析
- 02トランザクションメールと一括メールの送信
- 03テンプレートと連絡先の管理
- 04サンドボックスのメールとスパム分析の確認
- 05ドメイン、アカウント、トークンの管理
活用シーン
- 01配信とエンゲージメントの傾向を調査
- 02メールの送信やテスト
- 03連絡先リストとテンプレートの更新
- 04配信前にサンドボックスのメールを確認
MCP 対応
Mailtrapの分析、メール送信、連絡先、テンプレート、サンドボックス、ドメイン、アカウント操作をMCPクライアント向けツールとして提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
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 |
| Linux | mcpj-mailtrap-linux-x64 |
| Windows | mcpj-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_send | 1 回のリクエストで最大 500 件のメールを送信します |
send_test_email | テスト用にサンドボックスの受信トレイへ送信します。受信トレイと送信者の環境変数による既定値を任意で指定できます |
テンプレート
| ツール | 説明 |
|---|---|
list_templates | すべてのメールテンプレートを一覧表示します |
get_template | HTML/テキスト本文を含むテンプレートの詳細を取得します |
create_template | 新しいテンプレートを作成します |
update_template | 既存のテンプレートを更新します |
delete_template | テンプレートを削除します |
render_react_email | react-email コンポーネントファイル(.tsx、.jsx、.js、.mjs)を HTML とプレーンテキストに変換します |
連絡先
| ツール | 説明 |
|---|---|
create_contact | メールアドレス、カスタムフィールド、リストへの登録を指定して連絡先を作成します |
get_contact | UUID またはメールアドレスで連絡先を取得します |
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_domains | DNSステータスとともに送信ドメインを一覧表示します |
get_domain | DNSレコードを含むドメインの詳細を取得します |
manage_domain | 送信ドメインを作成または削除します |
send_domain_setup_instructions | DNS設定手順を同僚にメールで送信します |
アカウント
| ツール | 説明 |
|---|---|
list_accounts | アカウントを一覧表示するか、IDで1つ取得します |
get_billing_usage | プランの上限と現在の使用量を取得します |
manage_account_access | リソースの一覧表示、削除、権限の更新、確認を行います |
manage_api_token | APIトークンの一覧表示、取得、作成、削除、リセットを行います |
設定
| 変数 | 必須 | デフォルト | 説明 |
|---|---|---|---|
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
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。