Mailjet Mcp Server

Mailjet MCP サーバー

概要

このプロジェクトは、Mailjet API 用の Model Context Protocol（MCP）サーバーを提供し、互換性のある AI エージェント（例：Claude Desktop）が、標準化されたツールインターフェースを通じて Mailjet の連絡先、キャンペーン、セグメンテーション、統計、ワークフローなどの API を利用できるようにします。

クイックスタート

NPX から実行

このプロジェクトは NPM で公開されており、NPX から実行できます。

サーバーをローカルで起動するには、次のコマンドを実行してください。

MAILJET_API_KEY="YOUR_api_key:YOUR_secret_key" npx mailjet-mcp-server

多くの場合、AI デスクトップアプリを利用して Mailjet MCP を直接接続できます。その場合は、次の MCP 設定を追加してください。

"mcpServers": {
   "mailjet": {
      "command": "npx",
      "args": [
        "-y",
        "@mailjet/mailjet-mcp-server"
      ],
      "env": {
        "MAILJET_API_KEY": "YOUR_api_key:YOUR_secret_key"
      }
   }
}

手動インストール

1. リポジトリをクローンします。

   git clone https://github.com/mailgun/mailjet-mcp-server.git
   cd mailjet-mcp-server
   

2. 依存関係をインストールしてビルドします。

   pnpm install
   

3. Claude Desktop を設定します。

   設定ファイルを作成または編集します。

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

次に、MCP サーバーを起動します。

node src/mailjet-mcp.js

次の設定を追加します。

{
    "mcpServers": {
        "mailjet": {
            "command": "node",
            "args": ["CHANGE/THIS/PATH/TO/mailjet-mcp-server/src/mailjet-mcp.js"],
            "env": {
                "MAILJET_API_KEY": "YOUR_api_key:YOUR_secret_key"
            }
        }
    }
}

対応している環境変数

現在、サーバーで対応している環境変数は次のとおりです。

MAILJET_API_KEY="your_api_key:your_secret_key" # REQUIRED, used for authenticating your account
MAILJET_API_REGION="eu" # OPTIONAL, used to change to the EU servers, if desired

テスト

次のコマンドでローカルのテストスイートを実行します。

NODE_ENV=test pnpm test

Claude でのプロンプト例

連絡先情報を検索する

Which of my contacts lists has the most subscribers?

配信統計を取得して可視化する

Would you be able to make a chart with email delivery statistics for the past week?

デバッグ

MCP サーバーは stdio 経由で通信します。Model Context Protocol のデバッグのセクションを参照してください。

公開

このパッケージは Mailjet NPM レジストリで公開されています。新しいパッケージの更新は Mailjet チームが担当します。 Github バージョンと公開中の NPM パッケージに相違がある場合は、お気軽に issue を作成してください。

ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。詳細は LICENSE を参照してください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。