Servidor MCP de Email

O que faz o Servidor MCP “Email”?

O Servidor MCP de Email é um servidor Model Context Protocol (MCP) simples que permite ao seu assistente de IA enviar emails e anexar arquivos via SMTP. Atuando como uma ponte entre agentes de IA e sistemas de email externos, ele oferece ferramentas para funções básicas e avançadas de envio de email, incluindo conteúdo HTML, anexos, suporte a CC/BCC e teste de conexão SMTP. Este servidor otimiza fluxos de trabalho ao permitir que desenvolvedores e agentes de IA automatizem tarefas de comunicação, validem configurações SMTP e gerenciem configurações de email programaticamente—expandindo a capacidade do assistente de interagir com sistemas reais de mensagens e aumentando a produtividade para cenários de desenvolvimento e automação.

Lista de Prompts

Nenhum template de prompt explícito está documentado no repositório. Esta seção está vazia.

Lista de Recursos

Nenhum recurso MCP explícito é mencionado na documentação ou código. Esta seção está vazia.

Lista de Ferramentas

• send_email
  Ferramenta simples para envio de emails em texto puro ou HTML para destinatários usando as configurações SMTP configuradas. Requer destinatário, assunto e corpo.

• send_custom_email
  Ferramenta avançada de envio de emails com suporte a CC/BCC, anexos, formatação HTML e possibilidade de sobrescrever configurações SMTP por email.

• test_smtp_connection_tool
  Ferramenta utilitária para validar sua configuração SMTP e garantir que o envio de email está corretamente configurado antes do uso.

Casos de Uso deste Servidor MCP

• Notificações Automáticas por Email
  Agentes de IA podem enviar notificações instantâneas, lembretes ou atualizações de status para usuários ou equipes por email, otimizando os fluxos de comunicação.

• Distribuição de Arquivos e Relatórios
  Distribua relatórios, logs ou documentos gerados como anexos para um ou vários destinatários, reduzindo etapas manuais de compartilhamento.

• Comunicados de Equipe com Formatação
  Use suporte HTML para criar comunicados ou boletins visualmente atraentes com formatação rica e múltiplos destinatários via CC/BCC.

• Verificação de Configuração SMTP
  Desenvolvedores podem rapidamente checar e validar configurações SMTP para evitar falhas de envio durante implantações ou integrações.

• Automação de Envio Personalizado
  Automatize o envio de emails personalizados para onboarding, suporte ao cliente ou follow-up, usando IA para criar e entregar mensagens em escala.

Como configurar

Windsurf

Nenhuma instrução de configuração específica para Windsurf está disponível no repositório.

Claude

1. Instale o Software Necessário

   • Instale o uv (gerenciador de pacotes Python):
     curl -LsSf https://astral.sh/uv/install.sh | sh
     Reinicie o terminal ou execute source ~/.bashrc

2. Instale as Dependências do Projeto

   • cd email-mcp-server
   • uv sync

3. Teste a Instalação

   • uv run python test_email.py
   • (Opcional) Inicie o servidor: uv run main.py

4. Configure o Claude Desktop

   • Edite sua configuração do Claude Desktop e adicione:

{
  "mcpServers": {
    "mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/the/app/email-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "SMTP_HOST": "",
        "SMTP_PORT": "",
        "SMTP_SECURE": "",
        "SMTP_USER": "",
        "SMTP_FROM": "",
        "SMTP_PASS": ""
      }
    }
  }
}

Importante: Atualize o caminho do diretório conforme sua instalação.

Cursor

1. Instale o Software Necessário

   • Instale uv:
     curl -LsSf https://astral.sh/uv/install.sh | sh
     Reinicie o terminal ou execute source ~/.bashrc

2. Instale as Dependências do Projeto

   • cd email-mcp-server
   • uv sync

3. Teste a Instalação

   • uv run python test_email.py
   • (Opcional) Inicie o servidor: uv run main.py

4. Configure o Cursor

   • Edite seu arquivo de configuração e adicione:

{
  "mcpServers": {
    "mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/the/app/email-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "SMTP_HOST": "",
        "SMTP_PORT": "",
        "SMTP_SECURE": "",
        "SMTP_USER": "",
        "SMTP_FROM": "",
        "SMTP_PASS": ""
      }
    }
  }
}

Importante: Atualize o caminho do diretório conforme sua instalação.

Cline

Nenhuma instrução de configuração específica para Cline está disponível no repositório.

Protegendo Chaves de API Usando Variáveis de Ambiente

Configure credenciais SMTP sensíveis pela seção env na configuração do seu servidor MCP. Exemplo:

"env": {
  "SMTP_HOST": "smtp.gmail.com",
  "SMTP_PORT": "587",
  "SMTP_SECURE": "false",
  "SMTP_USER": "seu-email@gmail.com",
  "SMTP_FROM": "seu-email@gmail.com",
  "SMTP_PASS": "sua-senha-de-aplicativo"
}

Armazene segredos reais fora do arquivo de configuração sempre que possível.

Como usar este MCP nos fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo no FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do sistema MCP, insira os detalhes do seu servidor MCP neste formato JSON:

{
  "email-mcp": {
    "transport": "streamable_http",
    "url": "https://seumcpserver.exemplo/caminhoparamcp/url"
  }
}

Após configurado, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas as funções e capacidades. Lembre-se de alterar “email-mcp” para o nome real e atualizar a URL conforme necessário.

Visão Geral

Suporte a roots: Não mencionado

Suporte a sampling: Não mencionado

Com base nas tabelas acima, o Servidor MCP de Email oferece ferramentas robustas e claras para automação de emails, mas carece de templates de prompt documentados, recursos MCP explícitos e informações sobre recursos avançados de protocolo como roots ou sampling. A configuração é simples para Claude e Cursor, com suporte claro a variáveis de ambiente.

Nossa opinião

Este servidor MCP é direto e bem documentado para seu caso de uso principal, mas carece de recursos MCP avançados e recursos adicionais. É altamente funcional para tarefas de email, mas limitado em extensibilidade e profundidade de protocolo. Eu avaliaria como 6/10 para utilidade básica e documentação, com espaço para melhorias em completude de recursos e cobertura do protocolo MCP.

Pontuação MCP