mxHERO Multi-Account Email Search

Pesquise em várias contas de e-mail usando o serviço de busca vetorial da mxHERO.

Documentação

Servidor MCP para mxHERO Multi-Account Email Search

Descrição

Este servidor MCP (protocolo de contexto de modelo) é um projeto Go que fornece acesso ao serviço de busca de e-mail multi-conta da mxHERO.

O Protocolo de Contexto de Modelo (MCP) é uma estrutura projetada para padronizar a forma como os modelos interagem com várias fontes de dados e serviços. Neste projeto, o MCP é usado para facilitar a integração perfeita com o mxHERO Mail2Cloud Advanced. O Mail2Cloud Advanced é um serviço de dados de alto desempenho para os dados de e-mail de uma empresa. O Mail2Cloud Advanced conecta-se aos serviços de e-mail da empresa e otimiza o conteúdo para acesso rápido, escalável e seguro por soluções de IA.

Arquitetura

O Mail2Cloud é projetado para capturar seletivamente e-mails de uma ou mais contas. A seleção de e-mails pode ser finamente controlada por filtros poderosos que examinam qualquer aspecto das mensagens e seus anexos. Os e-mails capturados são então otimizados e armazenados em um tenant isolado em um banco de dados vetorial projetado para buscas relacionadas a e-mails. Este MCP acessa os e-mails armazenados no tenant por meio de credenciais de acesso autenticadas.

Vantagens

Soluções construídas com o Mail2Cloud Advanced MCP superam outras soluções de IA em relação à busca de dados de e-mail e recuperação de conhecimento (estudo)

Fornece links seguros para e-mails originais (protegidos contra exclusão acidental pelo usuário, etc.)
Permite que LLMs pesquisem repositórios massivos de e-mails, muito além das restrições de janela de contexto.

Contas de Demonstração

Para facilitar a exploração deste MCP, a mxHERO fornece contas de demonstração pré-carregadas com milhares de e-mails. Mais sobre os e-mails de demonstração podem ser encontrados aqui.

Para mais informações, consulte: mxHERO Mail2Cloud Advanced serviço de múltiplas contas de e-mail, incluindo arquitetura e otimizações.

Por que Go para implantação de MCP

Ao contrário dos MCPs em Python ou Javascript, Go compila para binário estático nativo. Uma vez compilado para uma arquitetura alvo (por exemplo, Mac ARM, Windows Intel) e instalado, nenhuma dependência adicional (software) é necessária no dispositivo do usuário.

Início Rápido

Para começar rapidamente, veja a seção de binários pré-compilados abaixo para o seu sistema operacional e arquitetura de máquina.
Siga as instruções de instalação.

Versões Alternativas

Uma versão em Python pode ser encontrada aqui.

HTTP Transmissível

Este repositório MCP é a variante 'stdio'. Opções HTTP existem nos seguintes endereços:

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

Ferramentas implementadas

email_search

Pesquisar e-mails armazenados

Parâmetros

query (str): Consulta de busca de e-mail

Retorna JSON dos resultados da busca

Requisitos

GO 1.22 ou superior (download)
Credenciais do mxHERO Vector Search (token)
- Tokens de acesso pessoal podem ser obtidos em https://lab4-mcp.mxhero.com/tokens

Instalação

Clone o repositório

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

Compile

Certifique-se de compilar para a arquitetura do computador do usuário. Você precisará combinar o sistema operacional e a arquitetura do processador. O Makefile incluído fornece algumas das mais comuns.

SO	Arquitetura	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 mais sistemas operacionais e arquiteturas, consulte a documentação de compilação do Go.

Exemplo de compilação

make mac-arm

Após executar make, o programa (binário) será colocado na pasta bin. Copie este binário para o computador do usuário e veja as instruções de configuração abaixo.

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

Nota

Algumas plataformas, como MacOS, exigirão permissões adicionais antes de permitir que o programa seja executado em outra máquina.

Binários Pré-compilados

Para conveniência, a pasta prebuilt contém binários pré-compilados e pacotes de instalação assinados. Veja o arquivo "readme" nessa pasta para mais informações.

Instalação

Se NÃO estiver instalando com um pacote de instalação, faça o seguinte:

Copie o binário (do sistema operacional e arquitetura correspondentes) para o computador do usuário. Coloque o arquivo em algum lugar onde o usuário tenha permissão de acesso. Por exemplo, o diretório inicial do usuário.
Garanta que o usuário tenha permissão para executar o programa (executar)
- Por exemplo, em Mac e Linux chmod 755 mxmcp

Configurando para Claude Desktop

O seguinte é um exemplo de configuração JSON para clientes comuns (por exemplo, Claude). Para detalhes de instalação de MCPs no Claude, veja https://modelcontextprotocol.io/quickstart/user

Edite seu claude_desktop_config.json
- Talvez seja necessário criar o arquivo se ele ainda não existir.
Adicione o seguinte JSON abaixo, onde:
- Observe que o JSON do mxhero-mcp-server deve ser adicionado junto com quaisquer outros servidores MCP da sua configuração.
  - Certifique-se de colocar o caminho completo como valor do comando. Por exemplo:
  - /Users/bob/mxmcp-mac-arm
  - Os parâmetros são:
  - O parâmetro '-t' (token) é obrigatório. - '-d' é uma descrição opcional de ferramenta personalizada.

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

Se o Claude estiver em execução, reinicie-o.

Aviso

Usar este cliente contra o serviço hospedado requer uma conta/chave de API e é regido pelos nossos Termos de Serviço.