TryKitt.ai mcp Server

Ein FastMCP-Server (Model Context Protocol), der E-Mail-Verifizierungs- und Suchfunktionen mithilfe der TryKitt.ai- API bereitstellt. Dieser Server ermöglicht KI-Assistenten, B2B-E-Mail-Adressen mit hoher Genauigkeit und niedrigen Bounce-Raten zu finden und zu verifizieren.

Merkmale

• E-Mail-Verifizierung : Verifizieren Sie E-Mail-Adressen mit erweiterter SMTP- und Catchall-Verifizierung

• E-Mail-Suche : Finden Sie E-Mail-Adressen von Einzelpersonen anhand ihres Namens und der Firmendomäne

• Jobverwaltung : Verfolgen und überwachen Sie die E-Mail-Verifizierung/Jobsuche

• Echtzeitverarbeitung : Erhalten Sie sofortige Ergebnisse für E-Mail-Vorgänge

• Hohe Genauigkeit : Nutzt die fortschrittlichen Verifizierungsalgorithmen von TryKitt.ai mit einer Absprungrate von <0,1 %

Related MCP server: Graphiti MCP Server

Installation

1. Klonen Sie dieses Repository:

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

2. Initialisieren Sie eine neue Python-Umgebung mit 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. Installieren Sie Abhängigkeiten mit uv:

# Using uv (recommended)
uv sync

Aufstellen

1. Holen Sie sich Ihren TryKitt.ai API-Schlüssel:

   • Besuchen Sie TryKitt.ai

   • Registrieren Sie sich für ein Konto

   • Navigieren Sie zu Ihren API-Einstellungen, um Ihren API-Schlüssel abzurufen

2. Legen Sie Ihren API-Schlüssel als Umgebungsvariable fest:

export TRYKITT_API_KEY="your_api_key_here"

Oder erstellen Sie eine .env Datei im Projektstammverzeichnis:

TRYKITT_API_KEY=your_api_key_here

Verwendung

Ausführen des Servers

Starten Sie den FastMCP-Server:

python server.py

Der Server wird gestartet und ist für MCP-Verbindungen verfügbar.

Hinzufügen zu MCP-Clients

Um diesen Server mit MCP-kompatiblen Clients zu verwenden, müssen Sie den Client für die Verbindung mit diesem Server konfigurieren.

Claude Desktop

Fügen Sie Ihrer Claude Desktop-Konfigurationsdatei die folgende Konfiguration hinzu:

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"
      }
    }
  }
}

Andere MCP-Clients

Konfigurieren Sie andere MCP-kompatible Clients für die Verbindung mit:

• Befehl : python

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

• Umgebungsvariablen : TRYKITT_API_KEY=your_api_key_here

Verwendung mit UV

Wenn Sie uv verwenden, können Sie den Server auch mit Folgendem ausführen:

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

Hinweis : Ersetzen Sie /path/to/your/trykittai-mcp-server durch den tatsächlichen absoluten Pfad zu Ihrem Projektverzeichnis und your_api_key_here durch Ihren tatsächlichen TryKitt.ai-API-Schlüssel.

Verfügbare Tools

1. E-Mail-Verifizierung ( verify_email_send )

Überprüfen Sie, ob eine E-Mail-Adresse gültig und zustellbar ist.

Parameter:

• email (erforderlich): Die zu verifizierende E-Mail-Adresse

• custom_data (optional): Benutzerdefinierte Daten, die mit der Anfrage verknüpft werden sollen

Beispiel:

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

2. E-Mail-Suche ( find_email )

Suchen Sie die E-Mail-Adresse einer Person anhand ihres Namens und der Firmendomäne.

Parameter:

• full_name (erforderlich): Der vollständige Name der Person

• domain (erforderlich): Die Unternehmensdomäne oder Website

• linkedin_url (optional): LinkedIn-Profil-URL für bessere Genauigkeit

• custom_data (optional): Benutzerdefinierte Daten, die mit der Anfrage verknüpft werden sollen

Beispiel:

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

3. Auftragsstatus ( get_job_status )

Überprüfen Sie den Status eines zuvor übermittelten Auftrags.

Parameter:

• job_id (erforderlich): Die ID des zu prüfenden Jobs

Beispiel:

result = await get_job_status("job_123456")

4. Jobs auflisten ( list_jobs )

Alle Jobs auflisten (Hinweis: Dieser Endpunkt ist möglicherweise nur eingeschränkt verfügbar).

Beispiel:

result = await list_jobs()

API-Antwortformat

Erfolgreiche E-Mail-Verifizierung

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

Erfolgreiches E-Mail-Finden

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

Fehlerbehandlung

Der Server verarbeitet verschiedene Fehlerszenarien:

• Ungültige API-Schlüssel

• Ratenbegrenzung

• Netzwerk-Timeouts

• Ungültige E-Mail-Formate

• Fehler bei der Domänenüberprüfung

Häufige Fehlerantworten:

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

Konfiguration

Umgebungsvariablen

• TRYKITT_API_KEY : Ihr TryKitt.ai API-Schlüssel (erforderlich)

SSL-Konfiguration

Der Server ist für die Zusammenarbeit mit den API-Endpunkten von TryKitt.ai konfiguriert. Die SSL-Verifizierung ist derzeit aus Kompatibilitätsgründen deaktiviert.

Entwicklung

Projektstruktur

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

Abhängigkeiten

• fastmcp : FastMCP-Framework zum Erstellen von MCP-Servern

• httpx : Asynchroner HTTP-Client für API-Anfragen

• pydantic : Datenvalidierung und Einstellungsverwaltung

Über TryKitt.ai

TryKitt.ai ist ein erweiterter Dienst zur E-Mail-Verifizierung und -Suche, der:

• Bietet unbegrenzte kostenlose E-Mail-Verifizierung für einzelne Benutzer

• Erreicht eine Absprungrate von <0,1 % durch erweiterte Überprüfung

• Funktioniert 2-5 Mal schneller als alternative Lösungen

• Verwendet Enterprise Identity Server zur Catchall-Verifizierung

• Erkennt Jobänderungen und validiert sie anhand realer Systeme

Erfahren Sie mehr unter https://trykitt.ai/

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Beitragen

1. Forken Sie das Repository

2. Erstellen eines Feature-Zweigs

3. Nehmen Sie Ihre Änderungen vor

4. Fügen Sie gegebenenfalls Tests hinzu

5. Senden einer Pull-Anfrage

Unterstützung

Bei Problemen im Zusammenhang mit:

• Dieser MCP-Server: Öffnen Sie ein Problem in diesem Repository

• TryKitt.ai API: Kontaktieren Sie den TryKitt.ai-Support

• FastMCP-Framework: Lesen Sie die FastMCP-Dokumentation

Änderungsprotokoll

Version 1.0.0

• Erstveröffentlichung mit E-Mail-Verifizierungs- und Suchfunktionen

• Auftragsstatusverfolgung

• Unterstützung der Echtzeitverarbeitung

• FastMCP-Integration