ClaudePost

Claude Post

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona una interfaz fluida para la gestión de correo electrónico a través de Claude. Esta integración permite gestionar correos electrónicos directamente mediante conversaciones en lenguaje natural con Claude, lo que permite funciones como la búsqueda, la lectura y el envío seguro de correos electrónicos.

Características y demostración

Búsqueda y lectura de correo electrónico

• 📧 Buscar correos electrónicos por rango de fechas y palabras clave
• 📅 Ver estadísticas diarias de correo electrónico
• 📝 Lea el contenido completo del correo electrónico con soporte para subprocesos

Redacción y envío de correos electrónicos

• ✉️ Enviar correos electrónicos con soporte para destinatarios CC
• Manejo seguro de correo electrónico con TLS

Prerrequisitos

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

Configuración

1. Instalar uv:
   # MacOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Remember to restart your terminal after installation
2. Clonar y configurar 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. Cree 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. Configurar Claude Desktop:Primero, asegúrate de tener instalado Claude para Escritorio. Puedes instalar la última versión aquí . Si ya tienes Claude para Escritorio, asegúrate de tener la última versión.Abra el 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
   Agregue la siguiente configuración:
   { "mcpServers": { "email": { "command": "/Users/username/.local/bin/uv", "args": [ "--directory", "/path/to/claude-post/src/email_client", "run", "email-client" ] } } }
   Reemplace /Users/username y /path/to/claude-post con sus rutas reales.Después de actualizar la configuración, reinicie 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 se inicie Claude si está configurado correctamente
• No es necesaria la gestión manual del servidor
• El servidor se detiene cuando se cierra Claude

Uso a través de Claude

Puedes interactuar con tus correos electrónicos mediante comandos de lenguaje natural. Aquí tienes algunos ejemplos:

Buscar correos electrónicos

• "Muéstrame los correos electrónicos de la semana pasada"
• "Buscar correos electrónicos con el asunto 'reunión'"
• Búsqueda de correos electrónicos de recruiting@linkedin.com entre el 01/01/2024 y el 07/01/2024
• "Buscar correos electrónicos enviados del último mes"

Leer el contenido del correo electrónico

• "Muéstrame el contenido del correo electrónico n.° 12345"
• "¿Cuál es el mensaje completo del último correo electrónico de RR.HH?"

Estadísticas de correo electrónico

• ¿Cuántos correos electrónicos recibí hoy?
• "Muéstrame el recuento diario de correos electrónicos de la última semana"

Enviar correos electrónicos

• Quiero enviar un correo electrónico a john@example.com
• Enviar confirmación de reunión a team@company.com

Nota: Por razones de seguridad, Claude siempre le mostrará los detalles del correo electrónico para confirmación antes de realizar el envío.

Estructura del proyecto

Notas de seguridad

• Utilice contraseñas específicas de la aplicación en lugar de la contraseña de su cuenta principal
• Para usuarios de Gmail:
  1. Habilite la verificación en dos pasos en su cuenta de Google
  2. Generar una contraseña de aplicación para esta aplicación
  3. Utilice la contraseña de la aplicación en su archivo .env

Explotación florestal

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

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.