ClaudePost

ClaudePost

Un servidor de Model Context Protocol (MCP) que proporciona una interfaz de gestión de correo electrónico sin interrupciones a través de Claude. Esta integración te permite manejar correos electrónicos directamente mediante conversaciones en lenguaje natural con Claude, con funciones como búsqueda, lectura y envío seguro de correos.

Características y Demostración

Búsqueda y Lectura de Correos

• 📧 Busca correos por rango de fechas y palabras clave
• 📅 Consulta estadísticas diarias de correos
• 📝 Lee el contenido completo de los correos con soporte de hilos

Redacción y Envío de Correos

• ✉️ Envía correos con soporte para destinatarios en copia (CC)
• 🔒 Manejo seguro de correos con TLS

Requisitos Previos

• Python 3.12 o superior
• Una cuenta de Gmail (u otro proveedor de correo)
• Si usas Gmail:
  • Autenticación de dos factores habilitada
  • Contraseña específica de la aplicación generada
• Aplicación de escritorio de Claude

Configuración

1. Instala uv:

   # MacOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Remember to restart your terminal after installation
   

2. Clona y configura el proyecto:

   # Clone the repository
   git clone https://github.com/ZilongXue/claude-post.git
   cd claude-post
   
   # Create and activate virtual environment
   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   
   # Install dependencies
   uv pip install -e .
   

3. Crea un archivo .env en la raíz del proyecto:

   EMAIL_ADDRESS=your.email@gmail.com
   EMAIL_PASSWORD=your-app-specific-password
   IMAP_SERVER=imap.gmail.com
   SMTP_SERVER=smtp.gmail.com
   SMTP_PORT=587
   

4. Configura Claude Desktop:

   Primero, asegúrate de tener Claude for Desktop instalado. Puedes instalar la versión más reciente aquí. Si ya tienes Claude for Desktop, asegúrate de que esté actualizado a la última versión.

   Abre tu archivo de configuración de Claude Desktop:

   # MacOS
   ~/Library/Application Support/Claude/claude_desktop_config.json
   
   # Create the file if it doesn't exist
   mkdir -p ~/Library/Application\ Support/Claude
   touch ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

   Agrega la siguiente configuración:

   {
     "mcpServers": {
       "email": {
         "command": "/Users/username/.local/bin/uv",
         "args": [
           "--directory",
           "/path/to/claude-post/src/email_client",
           "run",
           "email-client"
         ]
       }
     }
   }
   

   Reemplaza /Users/username y /path/to/claude-post con tus rutas reales.

   Después de actualizar la configuración, reinicia Claude Desktop para que los cambios surtan efecto.

Ejecución del Servidor

El servidor se ejecuta automáticamente a través de Claude Desktop:

• El servidor se iniciará cuando Claude se abra si está configurado correctamente
• No se necesita gestión manual del servidor
• El servidor se detiene cuando Claude se cierra

Uso a Través de Claude

Puedes interactuar con tus correos electrónicos usando comandos en lenguaje natural. Aquí hay algunos ejemplos:

Buscar Correos

• "Muéstrame los correos de la semana pasada"
• "Encuentra correos con el asunto que contenga 'reunión'"
• "Busca correos de recruiting@linkedin.com entre 2024-01-01 y 2024-01-07"
• "Busca correos enviados del mes pasado"

Leer Contenido de Correos

• "Muéstrame el contenido del correo #12345"
• "¿Cuál es el mensaje completo del último correo de Recursos Humanos?"

Estadísticas de Correos

• "¿Cuántos correos recibí hoy?"
• "Muéstrame los conteos diarios de correos de la semana pasada"

Enviar Correos

• "Quiero enviar un correo a john@example.com"
• "Envía una confirmación de reunión a team@company.com"

Nota: Por razones de seguridad, Claude siempre te mostrará los detalles del correo para confirmación antes de enviarlo realmente.

Estructura del Proyecto

claude-post/
├── pyproject.toml
├── README.md
├── LICENSE
├── .env                    # Not included in repo
├── .python-version        # Python version specification
└── src/
    └── email_client/
        ├── __init__.py
        ├── __main__.py
        └── server.py       # Main implementation

Notas de Seguridad

• Usa contraseñas específicas de la aplicación en lugar de la contraseña principal de tu cuenta
• Para usuarios de Gmail:
  1. Habilita la Verificación en Dos Pasos en tu Cuenta de Google
  2. Genera una Contraseña de Aplicación para esta aplicación
  3. Usa la Contraseña de Aplicación en tu archivo .env

Registro de Actividad

La aplicación registra información detallada en email_client.log. Revisa este archivo para obtener información de depuración y mensajes de error.

Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulta el archivo LICENSE para más detalles.