メールモド-mcp

これは、Mailmodo と Claude Desktop およびその他の MCP 対応クライアントとの統合用のメッセージ制御プロトコル (MCP) サーバーを実装する TypeScript プロジェクトです。

前提条件

• Node.js (v20以上を推奨)

• npm (Node.js に付属)

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Mailmodo 統合サーバーを自動的にインストールするには:

手動インストール

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

2. 依存関係をインストールします:

プロジェクトの構築

TypeScript コードを JavaScript にコンパイルするには、次のコマンドを実行します。

これにより、コンパイルされた JavaScript ファイルを含むdistディレクトリが作成されます。

プロジェクトの実行

ビルド後、次のコマンドを使用してプロジェクトを実行できます。

または、npm スクリプトを使用します。

クロードデスクトップ構成

コードからのローカル実行

このプロジェクトを Claude Desktop で構成するには、Claude Desktop 設定に次の構成を追加します。

Dockerイメージから実行

npxから実行

リモートサーバー経由で接続

ローカル プロジェクト ディレクトリと一致するように、 args配列内のファイル パスを調整してください。

発達

自動再コンパイルを使用して開発モードでプロジェクトを実行するには:

1. ts-nodeとnodemon開発依存関係としてインストールします。

2. package.json に開発スクリプトを追加します。

3. 開発サーバーを実行します。

プロジェクト構造

ツールとリソース

Mailmodo MCPサーバーは、Mailmodoの機能を利用するためのツールとリソースを複数提供しています。以下にその一覧を示します。

リソース

1. Mailmodo テンプレート( mailmodo://templates )

   • 利用可能なすべてのメールテンプレートのリストをJSON形式で返します

   • MIMEタイプ: application/json

2. Mailmodo キャンペーン( mailmodo://campaigns )

   • すべてのキャンペーンのリストをJSON形式で返します

   • MIMEタイプ: application/json

3. Mailmodo 連絡先リスト( mailmodo://contact-lists )

   • すべての連絡先リストをJSON形式で返します

   • MIMEタイプ: application/json

ツール

1. ユーザー詳細

   • 名前: userDetails

   • 説明: 連絡先のすべての詳細を取得します

   • パラメータ:

     • email (文字列): 連絡先のメールアドレス

2. キャンペーンレポートツール

   • 名前: MailmodoCampainReportTool

   • 説明: 開封数、クリック数、送信数などのキャンペーンレポートを取得します

   • パラメータ:

     • campaignId (UUID): キャンペーンのID

     • fromDate (YYYY-MM-DD): レポートの開始日

     • toDate (YYYY-MM-DD): レポートの終了日

3. 現在の日時

   • 名前: currentDateTime

   • 説明: 現在の日付と時刻を取得します

   • パラメータ: なし

4. イベントを送信

   • 名前: sendEvent

   • 説明: メールとイベントプロパティを使用してカスタムイベントを送信します

   • パラメータ:

     • email (文字列): 連絡先のメールアドレス

     • event_name (文字列): イベントの名前

     • ts (数値、オプション): タイムスタンプ

     • event_properties (オブジェクト、オプション): 追加のイベントプロパティ

5. 連絡先リスト管理

   • 連絡先をリストに追加

     • 名前: addContactToList

     • 説明: リストに単一の連絡先を追加する

     • パラメータ:

       • email (文字列): 連絡先のメールアドレス

       • listName (文字列): リストの名前

       • data （オブジェクト、オプション）: 連絡先のプロパティ

       • 連絡先メタデータのさまざまなオプションフィールド

   • 連絡先を一括追加

     • 名前: addBulkContactToList

     • 説明: 1 回の操作で複数の連絡先をリストに追加します

     • パラメータ:

       • listName (文字列): リストの名前

       • values （配列）：連絡先オブジェクトの配列

   • リストから連絡先を削除

     • 名前: removeContactFromList

     • 説明: 特定のリストから連絡先を削除します

     • パラメータ:

       • email (文字列): 連絡先のメールアドレス

       • listName (文字列): リストの名前

6. 連絡先ステータス管理

   • 購読解除のお問い合わせ

     • 名前: unsubscribeContact

     • 説明: 連絡先の登録を解除または抑制する

     • パラメータ:

       • email (文字列): 連絡先のメールアドレス

   • 再登録連絡先

     • 名前: resubscribeContact

     • 説明: 以前に登録解除した連絡先を再度登録する

     • パラメータ:

       • email (文字列): 連絡先のメールアドレス

   • アーカイブ連絡先

     • 名前: archiveContact

     • 説明: 連絡先を永久にアーカイブする

     • パラメータ:

       • email (文字列): 連絡先のメールアドレス

7. キャンペーン管理

   • メールキャンペーンの送信

     • 名前: sendEmailToCampaign

     • 説明: パーソナライゼーションによるメールキャンペーンをトリガーする

     • パラメータ:

       • campaignId (文字列): キャンペーンID

       • email (文字列): 受信者のメールアドレス

       • カスタマイズのためのさまざまなオプションパラメータ

   • 放送キャンペーン

     • 名前: broadcastCampaignToList

     • 説明: 連絡先リスト全体にキャンペーンをトリガーします

     • パラメータ:

       • campaignId (文字列): キャンペーンID

       • listId (文字列): 対象リストID

       • キャンペーンカスタマイズのオプションパラメータ

ライセンス

MITライセンス