Email

MCP Email Server

Um servidor Model Context Protocol que fornece funcionalidades de e-mail. Este servidor permite que LLMs componham e enviem e-mails, bem como busquem anexos em diretórios especificados.

Recursos

• Envie e-mails com vários destinatários
• Suporte para anexos de e-mail
• Busque arquivos em diretórios com base em correspondência de padrões
• Transmissão segura de e-mails usando SMTP

Ferramentas Disponíveis

• send_email - Envia e-mails com base no assunto, corpo e destinatário fornecidos.

  • receiver (array de strings, obrigatório): Lista de endereços de e-mail dos destinatários
  • body (string, obrigatório): O conteúdo principal do e-mail
  • subject (string, obrigatório): A linha de assunto do e-mail
  • attachments (array de strings ou string, opcional): Anexos de e-mail (nomes de arquivos)

• search_attachments - Busca arquivos em um diretório especificado que correspondam a um padrão determinado.

  • pattern (string, obrigatório): O padrão de texto a ser pesquisado nos nomes de arquivos

Prompts

• send_email

  • Envie um e-mail com anexos opcionais
  • Argumentos:
    • receiver (obrigatório): A lista de endereços de e-mail dos destinatários
    • body (obrigatório): O conteúdo principal do e-mail
    • subject (obrigatório): A linha de assunto do e-mail
    • attachments (opcional): Anexos de e-mail

• search_attachments

  • Busca arquivos que correspondam a um padrão
  • Argumentos:
    • pattern (obrigatório): O padrão de texto a ser pesquisado nos nomes de arquivos

Instalação

Usando pip

Instale as dependências necessárias:

pip install pydantic python-dotenv

Configuração de E-mail

Um arquivo email.json com configurações de servidor SMTP:

[
  {
    "domain": "@gmail.com",
    "server": "smtp.gmail.com", 
    "port": 587
  },
  {
    "domain": "@outlook.com",
    "server": "smtp.office365.com",
    "port": 587
  },
  {
    "domain": "@yahoo.com",
    "server": "smtp.mail.yahoo.com",
    "port": 587
  }
]

Uso

Executando o Servidor

Inicie o MCP Email Server com:

python -m mcp_email_server (--dir /path/to/attachment/directory)

Configurar para o Claude.app

Adicione às suas configurações do Claude:

Conda

{
  "mcpServers": {
    "email": {
      "command": "D:\\conda\\envs\\mcp\\python.exe",
      "args": [
        "C:\\Users\\YourUserName\\Desktop\\servers\\src\\email\\src\\mcp_server_email",
        "--dir",
        "C:\\Users\\YourUserName\\Desktop"
      ],
      "env": {
        "SENDER": "2593666979q@gmail.com",
        "PASSWORD": "tuogk......."
      }
    }
  }
}

UV

{
  "mcpServers": {
    "email": {
      "command": "uv",
      "args": [
        "~\\servers\\src\\email\\src\\mcp_server_email",
        "--dir",
        "C:\\Users\\YourUserName\\Desktop"
      ],
      "env": {
        "SENDER": "2593666979q@gmail.com",
        "PASSWORD": "tuogk......."
      }
    }
  }
}

Notas de Segurança

• Para Gmail e outros serviços, você pode precisar usar uma senha específica do aplicativo
• O servidor suporta um conjunto limitado de tipos de arquivos de anexo por motivos de segurança

Tipos de Arquivo Suportados

O servidor suporta os seguintes tipos de arquivos de anexo:

• Documentos: doc, docx, xls, xlsx, ppt, pptx, pdf
• Arquivos compactados: zip, rar, 7z, tar, gz
• Arquivos de texto: txt, log, csv, json, xml
• Imagens: jpg, jpeg, png, gif, bmp
• Outros: md

Exemplo de Uso

Enviando um E-mail

{
  "receiver": ["recipient@example.com"],
  "subject": "Test Email from MCP Server",
  "body": "This is a test email sent via the MCP Email Server.",
  "attachments": ["document.pdf", "image.jpg"]
}

Buscando Anexos

{
  "pattern": "report"
}

Contribuindo

Incentivamos contribuições para ajudar a expandir e melhorar o MCP Email Server. Se você deseja adicionar novas ferramentas, aprimorar funcionalidades existentes ou melhorar a documentação, sua contribuição é valiosa.

Para exemplos de outros servidores MCP e padrões de implementação, consulte: https://github.com/modelcontextprotocol/servers

Pull requests são bem-vindos! Sinta-se à vontade para contribuir com novas ideias, correções de bugs ou melhorias para tornar o MCP Email Server ainda mais poderoso e útil.

Licença

O MCP Email Server é licenciado sob a Licença MIT. Isso significa que você está livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT.