Servidor MCP de Yahoo Mail

Un servidor del Protocolo de Contexto de Modelo (MCP) que permite a los LLM interactuar con Yahoo Mail. Este servidor permite que herramientas como Claude Desktop lean, busquen y envíen correos electrónicos directamente a través de tu cuenta de Yahoo utilizando una autenticación OAuth2 segura.

Características (Planificadas)

• Leer correos electrónicos: Obtener mensajes recientes de tu bandeja de entrada.

• Buscar correos electrónicos: Buscar mensajes específicos usando palabras clave, remitentes o fechas.

• Enviar correos electrónicos: Redactar y enviar correos electrónicos usando los servidores SMTP de Yahoo.

Requisitos previos

• Node.js: Versión 20 o superior.

• Aplicación de desarrollador de Yahoo: Debes crear una aplicación en el Portal de desarrolladores de Yahoo para obtener las credenciales de OAuth2.

Creación de una aplicación de Yahoo para OAuth2

1. Ve al Portal de desarrolladores de Yahoo.

2. Crea una nueva aplicación.

3. Configura los Permisos de API para incluir Mail (Lectura y Escritura).

4. Configura el URI de redireccionamiento a https://localhost/callback (o tu URI preferido).

5. Anota tu ID de cliente y Secreto de cliente.

Configuración

1. Clona el repositorio:

   git clone <repository-url>
   cd yahoo-mail-mcp

2. Instala las dependencias:

   npm install

3. Configura las variables de entorno: Crea un archivo .env en el directorio raíz y añade tus credenciales de Yahoo:

   YAHOO_EMAIL=your-email@yahoo.com
   YAHOO_CLIENT_ID=your-client-id
   YAHOO_CLIENT_SECRET=your-client-secret
   YAHOO_REDIRECT_URI=https://localhost/callback

Autenticación

La primera vez que ejecutes el servidor, se iniciará un flujo de OAuth2:

1. Se abrirá una ventana del navegador pidiéndote que inicies sesión en Yahoo.

2. Después de autorizar, serás redirigido a tu REDIRECT_URI.

3. Es posible que la página no cargue, pero no importa: copia el parámetro code de la barra de direcciones.

4. Pega el código en tu terminal.

5. El servidor intercambiará el código por tokens y los guardará de forma segura en .tokens.json.

Uso

Desarrollo

Para ejecutar el servidor en modo de desarrollo con vite-node:

npm run dev

Compilación

Para compilar el proyecto para producción:

npm run build

Integración con Claude Desktop

Para usar este servidor con Claude Desktop, añádelo a tu claude_desktop_config.json:

{
  "mcpServers": {
    "yahoo-mail": {
      "command": "node",
      "args": ["/path/to/yahoo-mail-mcp/dist/index.js"]
    }
  }
}

Estructura del proyecto

• src/index.ts: Punto de entrada para el servidor MCP.

• src/server.ts: Inicialización del servidor MCP y registro de herramientas.

• src/auth/: Flujo de OAuth2 y gestión de tokens.

• src/tools/: Implementación de herramientas de correo electrónico individuales.

• src/lib/: Bibliotecas auxiliares para conexiones IMAP y SMTP.

Licencia

ISC