Servidor mcp de TryKitt.ai

Un servidor FastMCP (Protocolo de Contexto de Modelo) que proporciona funciones de verificación y búsqueda de correo electrónico mediante la API TryKitt.ai . Este servidor permite a los asistentes de IA encontrar y verificar direcciones de correo electrónico B2B con alta precisión y bajas tasas de rebote.

Características

• Verificación de correo electrónico : verifique direcciones de correo electrónico con SMTP avanzado y verificación general

• Búsqueda de correo electrónico : encuentre direcciones de correo electrónico de personas usando su nombre y dominio de la empresa

• Gestión de trabajos : seguimiento y control de la verificación de correo electrónico/búsqueda de trabajos

• Procesamiento en tiempo real : obtenga resultados inmediatos para las operaciones de correo electrónico

• Alta precisión : aprovecha los algoritmos de verificación avanzados de TryKitt.ai con una tasa de rebote <0,1 %

Related MCP server: Graphiti MCP Server

Instalación

1. Clonar este repositorio:

git clone https://github.com/avivshafir/trykittai-mcp-server
cd trykittai-mcp-server

2. Inicializar un nuevo entorno de Python con uv:

# Initialize a new uv project (if starting fresh)
uv init

# Or create a virtual environment
uv venv

# Activate the virtual environment
source .venv/bin/activate  # On macOS/Linux

3. Instalar dependencias usando uv:

# Using uv (recommended)
uv sync

Configuración

1. Obtén tu clave API de TryKitt.ai:

   • Visita TryKitt.ai

   • Regístrese para obtener una cuenta

   • Vaya a la configuración de su API para obtener su clave API

2. Establezca su clave API como una variable de entorno:

export TRYKITT_API_KEY="your_api_key_here"

O cree un archivo .env en la raíz del proyecto:

TRYKITT_API_KEY=your_api_key_here

Uso

Ejecución del servidor

Inicie el servidor FastMCP:

python server.py

El servidor se iniciará y estará disponible para conexiones MCP.

Agregar a clientes MCP

Para utilizar este servidor con clientes compatibles con MCP, deberá configurar el cliente para que se conecte a este servidor.

Escritorio de Claude

Agregue la siguiente configuración a su archivo de configuración de Claude Desktop:

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "trykittai": {
      "command": "python",
      "args": ["/path/to/your/trykittai-mcp-server/server.py"],
      "env": {
        "TRYKITT_API_KEY": "your_api_key_here"
      }
    }
  }
}

Otros clientes de MCP

Para otros clientes compatibles con MCP, configúrelos para que se conecten a:

• Comando : python

• Argumentos : ["/path/to/your/trykittai-mcp-server/server.py"]

• Variables de entorno : TRYKITT_API_KEY=your_api_key_here

Uso con uv

Si está utilizando uv, también puede ejecutar el servidor con:

{
  "mcpServers": {
    "trykittai": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/your/trykittai-mcp-server",
      "env": {
        "TRYKITT_API_KEY": "your_api_key_here"
      }
    }
  }
}

Nota : reemplace /path/to/your/trykittai-mcp-server con la ruta absoluta real a su directorio de proyecto y your_api_key_here con su clave API de TryKitt.ai real.

Herramientas disponibles

1. Verificación de correo electrónico ( verify_email_send )

Verificar si una dirección de correo electrónico es válida y se puede entregar.

Parámetros:

• email (obligatorio): La dirección de correo electrónico para verificar

• custom_data (opcional): datos personalizados para asociar con la solicitud

Ejemplo:

result = await verify_email_send("john.doe@example.com")

2. Búsqueda de correo electrónico ( find_email )

Busque una dirección de correo electrónico para una persona según su nombre y el dominio de su empresa.

Parámetros:

• full_name (obligatorio): El nombre completo de la persona

• domain (obligatorio): El dominio o sitio web de la empresa

• linkedin_url (opcional): URL del perfil de LinkedIn para una mayor precisión

• custom_data (opcional): datos personalizados para asociar con la solicitud

Ejemplo:

result = await find_email(
    full_name="John Doe",
    domain="example.com",
    linkedin_url="https://linkedin.com/in/johndoe"
)

3. Estado del trabajo ( get_job_status )

Comprobar el estado de un trabajo enviado anteriormente.

Parámetros:

• job_id (obligatorio): El ID del trabajo a comprobar

Ejemplo:

result = await get_job_status("job_123456")

4. Lista de trabajos ( list_jobs )

Enumere todos los trabajos (Nota: este punto final puede tener disponibilidad limitada).

Ejemplo:

result = await list_jobs()

Formato de respuesta de la API

Verificación de correo electrónico exitosa

{
  "id": "job_123456",
  "status": "completed",
  "result": {
    "email": "john.doe@example.com",
    "valid": true,
    "deliverable": true,
    "confidence": 0.95,
    "verification_type": "smtp_catchall"
  }
}

Búsqueda exitosa de correos electrónicos

{
  "id": "job_789012",
  "status": "completed",
  "result": {
    "email": "john.doe@example.com",
    "confidence": 0.88,
    "sources": ["pattern_matching", "web_scraping"]
  }
}

Manejo de errores

El servidor gestiona varios escenarios de error:

• Claves API no válidas

• Limitación de velocidad

• Tiempos de espera de la red

• Formatos de correo electrónico no válidos

• Errores de verificación de dominio

Respuestas de error comunes:

{
  "error": "Invalid API key",
  "code": 401
}

Configuración

Variables de entorno

• TRYKITT_API_KEY : Su clave API de TryKitt.ai (obligatoria)

Configuración SSL

El servidor está configurado para funcionar con los puntos finales de la API de TryKitt.ai. La verificación SSL está deshabilitada por compatibilidad.

Desarrollo

Estructura del proyecto

trykittai-mcp-server/
├── server.py          # Main FastMCP server implementation
├── pyproject.toml     # Project dependencies and configuration
├── uv.lock           # Dependency lock file
├── README.md         # This file
├── LICENSE           # MIT License
└── .venv/            # Virtual environment

Dependencias

• fastmcp : marco FastMCP para crear servidores MCP

• httpx : Cliente HTTP asíncrono para solicitudes API

• pydantic : Validación de datos y gestión de configuraciones

Acerca de TryKitt.ai

TryKitt.ai es un servicio avanzado de verificación y búsqueda de correo electrónico que:

• Proporciona verificación de correo electrónico gratuita e ilimitada para usuarios individuales

• Logra tasas de rebote <0,1% mediante verificación avanzada

• Funciona de 2 a 5 veces más rápido que las soluciones alternativas

• Utiliza servidores de identidad empresarial para la verificación general

• Detecta cambios de trabajo y los valida contra sistemas reales

Obtenga más información en https://trykitt.ai/

Licencia

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

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

3. Realiza tus cambios

4. Agregue pruebas si corresponde

5. Enviar una solicitud de extracción

Apoyo

Para cuestiones relacionadas con:

• Este servidor MCP: Abra un problema en este repositorio

• API de TryKitt.ai: Contacta con el soporte de TryKitt.ai

• Marco FastMCP: consulte la documentación de FastMCP

Registro de cambios

versión 1.0.0

• Versión inicial con verificación de correo electrónico y capacidades de búsqueda

• Seguimiento del estado del trabajo

• Soporte de procesamiento en tiempo real

• Integración de FastMCP