金大哥 - mxmcp-py MCP 详情

article

README

🚀 mxHERO多账户邮件搜索的MCP服务器

本MCP（模型上下文协议）服务器是一个Python项目，它提供了对mxHERO的Mail2Cloud Advanced多账户邮件搜索服务的访问途径。

模型上下文协议（MCP）是一个旨在规范模型与各种数据源和服务交互方式的框架。在本项目中，MCP用于实现与mxHERO Mail2Cloud Advanced的无缝集成。Mail2Cloud Advanced是一项针对企业邮件数据的高性能数据服务。它连接到企业邮件服务，并对内容进行优化，以便AI解决方案能够快速、可扩展且安全地访问这些数据。

🚀 快速开始

本MCP服务器为用户提供了便捷的方式来访问mxHERO的多账户邮件搜索服务。通过以下步骤，你可以快速开启邮件搜索之旅。

✨ 主要特性

高效架构：Mail2Cloud能够有选择地从一个或多个账户捕获邮件，并通过强大的过滤器进行精细控制。捕获的邮件会被优化并存储到专为邮件相关搜索设计的向量数据库的独立租户中。
性能卓越：基于Mail2Cloud Advanced MCP构建的解决方案在邮件数据搜索和知识恢复方面优于其他AI解决方案。
安全可靠：提供指向原始邮件的安全链接，避免用户意外删除等情况。
突破限制：允许大语言模型（LLMs）搜索海量邮件存储库，突破其上下文窗口的限制。

📦 安装指南

克隆仓库

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

安装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"

创建并设置项目

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作为客户端

编辑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

mxmcp-py