Mxmcp Py

🚀 mxHERO多アカウントメール検索用MCPサーバー

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

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

🚀 クイックスタート

このMCPサーバーを使用することで、mxHEROのMail2Cloud Advanced多アカウントメール検索サービスにアクセスできます。以下に、インストールと使用方法を説明します。

✨ 主な機能

アーキテクチャ

Mail2Cloudは、1つまたは複数のアカウントからメールを選択的にキャプチャするように設計されています。メールの選択は、メッセージや添付ファイルのあらゆる側面を調べる強力なフィルターによって細かく制御できます。キャプチャされたメールは、メール関連の検索用に設計されたベクターデータベース内の分離されたテナントに最適化されて保存されます。このMCPは、認証されたアクセス資格情報を通じてテナント内に保存されたメールにアクセスします。

利点

Mail2Cloud Advanced MCPを使用して構築されたソリューションは、メールデータの検索と知識回復に関して他のAIソリューションを上回っています（調査）。

• 元のメールへの安全なリンクを提供します（ユーザーの誤削除などから保護されます）。
• LLMがコンテキストウィンドウの制限をはるかに超えた大量のメールリポジトリを検索できるようにします。

デモアカウント

このMCPの探索を容易にするために、mxHEROは数千のメールが事前にロードされたデモアカウントを提供しています。デモメールの詳細については、こちらを参照してください。

トークンを取得するには、以下の「アクセストークン」を参照してください。

詳細情報については、mxHERO Mail2Cloud Advancedの多メールアカウントサービスを参照してください。これには、アーキテクチャや最適化が含まれます。

📦 インストール

代替バージョン

Goバージョン（および事前ビルドされたバイナリ）は、こちらで見つけることができます。

ストリーミング可能なHTTP

このMCPリポジトリは「stdio」バリアントです。HTTPオプションは以下のアドレスに存在します。

• https://lab4-api.mxhero.com/mcp/connect（ストリーミング可能なHTTP）
• https://lab4-api.mxhero.com/mcp/sse（レガシーSSE）

インストール手順

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>"
            ]
        }
    }
}

📚 ドキュメント

実装されたツール

email_search

保存されたメールを検索します。 パラメーター

• query (str): メール検索クエリ 戻り値 検索結果のJSON

要件

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

アクセストークン

• デモトークンは、https://lab4-api.mxhero.com/demo_signup で取得できます。
• 本番用のトークンについては、「デモ」をオフにしてアカウントを要求するか（またはcontact@mxhero.comまでmxHEROに連絡してください）。

MCPライブラリ

https://gofastmcp.com/servers/tools