mxHERO Multi-Account Email Search

Servidor MCP para búsqueda de correo multi-cuenta de mxHERO

Descripción

Este servidor MCP (protocolo de contexto de modelo) es un proyecto en Go que proporciona acceso al servicio de búsqueda de correo multi-cuenta de mxHERO.

El Protocolo de Contexto de Modelo (MCP) es un marco diseñado para estandarizar la forma en que los modelos interactúan con diversas fuentes de datos y servicios. En este proyecto, MCP se utiliza para facilitar la integración perfecta con mxHERO Mail2Cloud Advanced. Mail2Cloud Advanced es un servicio de datos de alto rendimiento para los datos de correo electrónico de una empresa. Mail2Cloud Advanced se conecta a los servicios de correo de la empresa y optimiza el contenido para un acceso rápido, escalable y seguro por parte de soluciones de IA.

Arquitectura

Mail2Cloud está diseñado para capturar selectivamente correos electrónicos de una o más cuentas. La selección de correos puede controlarse finamente mediante potentes filtros que examinan cualquier aspecto de los mensajes y sus adjuntos. Los correos capturados se optimizan y se almacenan en un tenant aislado en una base de datos vectorial diseñada para búsquedas relacionadas con correos electrónicos. Este MCP accede a los correos almacenados en el tenant mediante credenciales de acceso autenticadas.

Ventajas

Las soluciones construidas con Mail2Cloud Advanced MCP superan a otras soluciones de IA en cuanto a búsqueda de datos de correo y recuperación de conocimiento (estudio)

• Proporciona enlaces seguros a los correos originales (a salvo de eliminación accidental por parte del usuario, etc.)
• Permite a los LLM buscar en repositorios masivos de correos, mucho más allá de las limitaciones de su ventana de contexto.

Cuentas de demostración

Para facilitar la exploración de este MCP, mxHERO proporciona cuentas de demostración precargadas con miles de correos electrónicos. Más información sobre los correos de demostración se puede encontrar aquí.

Para más información, consulte: mxHERO Mail2Cloud Advanced servicio de cuentas de correo múltiples, incluyendo arquitectura y optimizaciones.

Por qué Go para el despliegue de MCP

A diferencia de los MCP en Python o Javascript, Go compila a un binario estático nativo. Una vez compilado para una arquitectura objetivo (por ejemplo, Mac ARM, Windows Intel) e instalado, no se requieren dependencias adicionales (software) en el dispositivo del usuario.

Inicio rápido

1. Para comenzar rápidamente, consulte la sección de binarios precompilados a continuación para su sistema operativo y arquitectura de máquina.
2. Siga las instrucciones de instalación.

Versiones alternativas

Se puede encontrar una versión en Python aquí.

HTTP transmisible

Este repositorio MCP es la variante 'stdio'. Existen opciones HTTP en las siguientes direcciones:

• https://lab4-mcp.mxhero.com/mcp2/connect (streamable HTTP)

Herramientas implementadas

email_search

Buscar correos almacenados

Parámetros

• query (str): Consulta de búsqueda de correo

Devuelve JSON de los resultados de búsqueda

Requisitos

• GO 1.22 o superior (descargar)
• Credenciales de mxHERO Vector Search (token)
  • Los tokens de acceso personal se pueden obtener en https://lab4-mcp.mxhero.com/tokens

Instalación

1. Clonar el repositorio

git clone https://github.com/mxaiorg/mxmcp
cd mxmcp
go mod tidy

2. Compilar

Asegúrese de compilar para la arquitectura del ordenador del usuario. Deberá coincidir con el sistema operativo y la arquitectura del procesador. El Makefile incluido proporciona soporte para algunas de las más comunes.

SO	Arquitectura	Comando make
Windows	Intel	make windows-intel
Mac	Arm (Mac silicon - M1...)	make mac-arm
Mac	Intel	make mac-intel
Linux	Intel	make linux-intel

Para más sistemas operativos y arquitecturas, consulte la documentación de compilación de Go.

Ejemplo de compilación

make mac-arm

Después de ejecutar make, se colocará el programa (binario) en la carpeta bin. Copie este binario al ordenador del usuario y consulte las instrucciones de configuración a continuación.

Por ejemplo: cp bin/mxmcp-mac-arm ~user

Nota

• Algunas plataformas, como MacOS, requerirán permisos adicionales antes de permitir que el programa se ejecute en otra máquina.

Binarios precompilados

Por conveniencia, la carpeta prebuilt contiene binarios precompilados y paquetes de instalación firmados. Consulte el archivo "readme" en esa carpeta para más información.

Instalación

Si NO se instala con un paquete de instalación, haga lo siguiente:

1. Copie el binario (del sistema operativo y arquitectura correspondientes) al ordenador del usuario. Coloque el archivo en un lugar al que el usuario tenga permiso de acceso. Por ejemplo, el directorio de inicio del usuario.
2. Asegúrese de que el usuario tenga permiso para ejecutar el programa (ejecutar)
   • Por ejemplo, en Mac y Linux chmod 755 mxmcp

Configuración para Claude Desktop

El siguiente es un ejemplo de configuración JSON para clientes comunes (p. ej., Claude). Para detalles sobre la instalación de MCP en Claude, consulte https://modelcontextprotocol.io/quickstart/user

1. Edite su archivo claude_desktop_config.json
   • Puede que necesite crear el archivo si no existe.
2. Agregue el siguiente JSON a continuación, donde:
   • Nota: el JSON de mxhero-mcp-server debe agregarse junto a cualquier otro servidor MCP de su configuración.
     • Asegúrese de poner la ruta completa como valor del comando. Por ejemplo:
     • /Users/bob/mxmcp-mac-arm
     • Los parámetros son:
     • El parámetro '-t' (token) es obligatorio. - '-d' es una descripción de herramienta personalizada opcional.

{
  "mcpServers": {
    "mxhero-mcp-server": {
      "command": "<full path to mxmcp>",
      "args": [
        "-t",
        "<token>",
        "-d",
        "<optional custom tool description>"
      ]
    }
  }
}

3. Si Claude está en ejecución, reinícielo.

Aviso

El uso de este cliente contra el servicio alojado requiere una cuenta/clave de API y está sujeto a nuestros Términos de Servicio.