Servidor MCP de MailboxValidator

Esta es una implementación sencilla de servidor del Protocolo de Contexto de Modelo (MCP) para la API de MailboxValidator. Devolverá el resultado de la validación para una dirección de correo electrónico.

Características

• Validación integral de correo electrónico: Comprueba una dirección de correo electrónico para ver si es accesible verificando la sintaxis, el DNS, el servidor MX, el alto riesgo, la lista de supresión y más.

• Correo electrónico desechable: Comprueba una dirección de correo electrónico para ver si proviene de un proveedor de correo electrónico temporal/desechable.

• Correo electrónico gratuito: Comprueba una dirección de correo electrónico para ver si proviene de un proveedor de correo electrónico gratuito.

Requisitos

Este servidor MCP requiere una clave de API. También puede registrarse para obtener una clave de API gratuita y disfrutar de hasta 300 consultas al mes.

La configuración también utiliza Node.js y npm, que se pueden descargar en el sitio web de Node.js.

Configuración

Siga los pasos para utilizar este servidor MCP con Claude Desktop:

1. Descargue el repositorio en su equipo local.

2. Ejecute los siguientes comandos dentro de la carpeta del proyecto para instalar las dependencias y compilar el servidor.

npm install
npm run build

3. Asegúrese de haber instalado Claude Desktop; si no lo ha hecho, descárguelo desde aquí para usuarios de Windows y MacOS, o siga esta guía para usuarios de Linux.

4. Abra el archivo claude_desktop_config.json en el editor de su elección; si aún no tiene uno, siga esta guía para crear uno.

5. Añada lo siguiente a su claude_desktop_config.json:

{
  "mcpServers": {
    "mailboxvalidator": {
      "command": "node",
      "args": [
        "C:\\path\\to\\mcp-mailboxvalidator\\build\\index.js"
      ],
      "env": {
        "MAILBOXVALIDATOR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

6. Recuerde reemplazar la ruta de index.js con la ruta real a su servidor MCP de MailboxValidator en su máquina local.

7. Para obtener su clave de API, simplemente inicie sesión en su panel de control y obténgala desde allí. Reemplace <YOUR_API_KEY> en el código anterior con su clave de API real.

8. Reinicie Claude Desktop después de guardar los cambios y debería verlo aparecer en el menú Search and tools.

Uso

Simplemente introduzca su consulta sobre la dirección de correo electrónico en un chat en Claude Desktop. Algunos ejemplos de consultas serían:

• ¿Es (email) una dirección de correo electrónico válida?

• ¿Es (email) un correo electrónico falso?

• ¿Es (email) un correo electrónico gratuito?

En Claude Desktop, el modelo generará automáticamente la salida basada en el resultado devuelto por el servidor MCP de MailboxValidator.

Variable de entorno

MAILBOXVALIDATOR_API_KEY

La clave de API gratuita de MailboxValidator le permite consultar hasta 300 correos electrónicos al mes. Si necesita más, puede registrarse en un plan de API de pago.

Herramienta

validate_email

Descripción Valida la dirección de correo electrónico proporcionada. Ayuda a los usuarios a determinar si una dirección de correo electrónico es potencialmente accesible comprobando la sintaxis, el DNS, el servidor MX, la lista de desechables y más.

Argumentos email (str): La dirección de correo electrónico a validar.

Retorno Una cadena JSON que contiene los datos de validación. El resultado incluye los siguientes campos:

• Sintaxis: Comprueba que la dirección de correo electrónico se ajuste al formato correcto.

• DNS y servidor MX: Comprueba que el DNS del dominio tenga un servidor MX especificado.

• Red y conectividad: Intenta establecer conexión con el servidor MX para asegurarse de que esté operativo.

• Greylisting: Comprueba si el servidor MX está utilizando greylisting, lo que podría causar que el correo enviado a esa dirección sea rechazado.

• Lista de desechables: Comprueba si el dominio del correo electrónico proviene de un proveedor de correo electrónico temporal o desechable.

• Alto riesgo y lista de supresión: Comprueba si el nombre de usuario del correo electrónico parece de alto riesgo o si la dirección de correo electrónico se encuentra en una lista de supresión.

• Otros: Comprueba la puntuación de reputación del correo electrónico y mucho más.

Si la solicitud falla, la herramienta devolverá un mensaje de error como cadena.

check_disposable_email

Descripción Comprueba si la dirección de correo electrónico proporcionada proviene de un proveedor de correo electrónico desechable.

Argumentos email (str): La dirección de correo electrónico a comprobar.

Retorno Una cadena JSON que contiene los datos de correo electrónico desechable. El resultado incluye los siguientes campos:

• Lista de desechables: Comprueba si el dominio del correo electrónico proviene de un proveedor de correo electrónico temporal o desechable.

Si la solicitud falla, la herramienta devolverá un mensaje de error como cadena.

check_free_email

Descripción Comprueba si la dirección de correo electrónico proporcionada proviene de un proveedor de correo electrónico gratuito.

Argumentos email (str): La dirección de correo electrónico a comprobar.

Retorno Una cadena JSON que contiene los datos de correo electrónico gratuito. El resultado incluye los siguientes campos:

• Lista de correo electrónico gratuito: Comprueba si el dominio del correo electrónico proviene de un proveedor de correo electrónico gratuito.

Si la solicitud falla, la herramienta devolverá un mensaje de error como cadena.

Licencia

Consulte el archivo LICENSE.