Mxmcp Py

🚀 mxHERO多賬戶郵件搜索的MCP服務器

本MCP（模型上下文協議）服務器是一個Python項目，它提供了對mxHERO的Mail2Cloud Advanced多賬戶郵件搜索服務的訪問途徑。

模型上下文協議（MCP）是一個旨在規範模型與各種數據源和服務交互方式的框架。在本項目中，MCP用於實現與mxHERO Mail2Cloud Advanced的無縫集成。Mail2Cloud Advanced是一項針對企業郵件數據的高性能數據服務。它連接到企業郵件服務，並對內容進行優化，以便AI解決方案能夠快速、可擴展且安全地訪問這些數據。

🚀 快速開始

本MCP服務器為用戶提供了便捷的方式來訪問mxHERO的多賬戶郵件搜索服務。通過以下步驟，你可以快速開啟郵件搜索之旅。

✨ 主要特性

• 高效架構：Mail2Cloud能夠有選擇地從一個或多個賬戶捕獲郵件，並通過強大的過濾器進行精細控制。捕獲的郵件會被優化並存儲到專為郵件相關搜索設計的向量數據庫的獨立租戶中。
• 性能卓越：基於Mail2Cloud Advanced MCP構建的解決方案在郵件數據搜索和知識恢復方面優於其他AI解決方案。
• 安全可靠：提供指向原始郵件的安全鏈接，避免用戶意外刪除等情況。
• 突破限制：允許大語言模型（LLMs）搜索海量郵件存儲庫，突破其上下文窗口的限制。

📦 安裝指南

1. 克隆倉庫

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

2. 安裝uv（若尚未安裝）
   • MacOS + Linux

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

   • Windows

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

3. 創建並設置項目
   • MacOS + Linux

   # 創建虛擬環境並激活
   uv venv
   source .venv/bin/activate
   
   # 鎖定依賴項
   uv lock
   

   • Windows

   # 創建虛擬環境並激活
   uv venv
   .venv\Scripts\activate
   
   # 鎖定依賴項
   uv lock
   

💻 使用示例

基礎用法

• 啟動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
  

  若文件不存在，你可能需要創建它。 2. 添加配置：

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

  請將--directory參數的值（/Users/...）替換為Python腳本的絕對（完整）路徑。

📚 詳細文檔

架構

Mail2Cloud旨在有選擇地從一個或多個賬戶捕獲郵件。郵件的選擇可以通過強大的過濾器進行精細控制，這些過濾器可以檢查郵件及其附件的任何方面。捕獲的郵件隨後會被優化並存儲到專為郵件相關搜索設計的向量數據庫的獨立租戶中。本MCP通過經過身份驗證的訪問憑證訪問租戶中存儲的郵件。

優勢

基於Mail2Cloud Advanced MCP構建的解決方案在郵件數據搜索和知識恢復方面優於其他AI解決方案（研究）：

• 提供指向原始郵件的安全鏈接（避免用戶意外刪除等情況）。
• 允許大語言模型（LLMs）搜索海量郵件存儲庫，突破其上下文窗口的限制。

演示賬戶

為了方便探索本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）

🔧 技術細節

工具實現

email_search

搜索存儲的郵件

參數

• query（字符串）：郵件搜索查詢

返回 搜索結果的JSON

要求

• Python 3.13或更高版本
• mxHERO向量搜索 令牌

訪問令牌

• 演示令牌可在https://lab4-api.mxhero.com/demo_signup獲取。
• 對於生產令牌，請取消選中“演示”並請求賬戶（或通過contact@mxhero.com聯繫mxHERO）。

MCP庫

https://gofastmcp.com/servers/tools