mxHERO Mail2Cloud MCP

mxHERO マルチアカウントメール検索用 MCP サーバー

説明

この MCP（モデルコンテキストプロトコル）サーバーは、mxHERO の Mail2Cloud Advanced マルチアカウントメール検索サービスへのアクセスを提供する Python プロジェクトです。

Model Context Protocol（MCP）は、モデルがさまざまなデータソースやサービスと連携する方法を標準化するために設計されたフレームワークです。このプロジェクトでは、MCP を使用して mxHERO Mail2Cloud Advanced とのシームレスな統合を実現します。Mail2Cloud Advanced は、企業のメールデータを対象とする高性能データサービスです。Mail2Cloud Advanced は企業のメールサービスに接続し、AI ソリューションが高速で、スケーラブルかつ安全にアクセスできるよう、コンテンツを最適化します。

アーキテクチャ

Mail2Cloud は、1 つ以上のアカウントからメールを選択的に取り込むよう設計されています。メッセージや添付ファイルのあらゆる要素を調べる強力なフィルターを使って、取り込むメールを細かく制御できます。取り込まれたメールは最適化され、メール関連の検索向けに設計されたベクトルデータベース内の分離されたテナントに保存されます。この MCP は、認証済みのアクセス資格情報を使用して、テナントに保存されたメールにアクセスします。

メリット

Mail2Cloud Advanced MCP で構築されたソリューションは、メールデータの検索とナレッジの復元において、他の AI ソリューションを上回ります（調査）。

• 元のメールへの安全なリンクを提供します（ユーザーが誤って削除するなどのリスクを防ぎます）。
• LLM が、コンテキストウィンドウの制限を大幅に超える膨大なメールリポジトリを検索できるようにします。

デモアカウント

この MCP を試しやすくするため、mxHERO は数千通のメールがあらかじめ読み込まれたデモアカウントを提供しています。デモメールについて詳しくはこちらをご覧ください。

トークンの取得方法については、以下の「アクセストークン」をご覧ください。

詳細については、mxHERO Mail2Cloud Advanced のマルチメールアカウントサービスと、アーキテクチャ、最適化をご覧ください。

別バージョン

Go バージョン（ビルド済みバイナリを含む）はこちらにあります。

Streamable HTTP

この MCP リポジトリは「stdio」版です。HTTP オプションは次のアドレスで利用できます。

• https://lab4-api.mxhero.com/mcp/connect（Streamable HTTP）
• https://lab4-api.mxhero.com/mcp/sse（レガシー SSE）

実装済みのツール

email_search

保存されたメールを検索します

パラメーター

• query (str)：メール検索クエリ

戻り値 検索結果の JSON

要件

• Python 3.13 以降
• mxHERO Vector Search トークン

アクセストークン

• デモトークンは https://lab4-api.mxhero.com/demo_signup で取得できます
• 本番用トークンを取得するには、「Demo」のチェックを外してアカウントをリクエストするか、mxHERO（[email protected]）にお問い合わせください。

インストール

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

git clone https://github.com/mxaiorg/mxmcp-py

2. uv がまだインストールされていない場合は、インストールします。

   2.1 MacOS+Linux

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   2.2 Windows

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

3. プロジェクトを作成してセットアップします。

   3.1 MacOS+Linux

   # 仮想環境を作成して有効化します
   uv venv
   source .venv/bin/activate
   
   # 依存関係をロックします
   uv lock
   

   3.2 Windows

   # 仮想環境を作成して有効化します
   uv venv
   .venv\Scripts\activate
   
   # 依存関係をロックします
   uv lock
   

使用方法

MCP サーバーの起動

MCP サーバーを起動するには、次のコマンドを実行します。

uv --directory /fullpath/PycharmProjects/mxmcp-py run src/mxmcp.py --token "my_token"

通常、サーバーを起動する必要はありません。クライアントが起動しますが、正常に動作することを確認するのに役立ちます。

Claude をクライアントとして使用する

1. claude_desktop_config.json を編集します。

   code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

   ...または、お好みの JSON エディターを使用します。

   • ファイルがまだ存在しない場合は、作成が必要になることがあります。

2. 設定を追加します。

• --directory 引数の値（'/Users/...'）を、Python スクリプトへの絶対パス（フルパス）に置き換えます。

  {
      "mcpServers": {
          "mxhero-mcp-server": {
              "command": "uv",
              "args": [
                  "--directory",
                  "/Users/your_user/Desktop/mxmcp-py",
                  "run",
                  "src/mxmcp.py",
                  "--token",
                  "<copy_your_token_here>"
              ]
          }
      }
  }
  

MCP ライブラリ

https://gofastmcp.com/servers/tools

注意

このクライアントをホスト型サービスに接続して使用するには、アカウント/API キーが必要です。また、当社の利用規約が適用されます。