Trykittai-MCP-Server

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 %

Installation

Klonen Sie dieses Repository:

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

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

Installieren Sie Abhängigkeiten mit uv:

# Using uv (recommended)
uv sync

Aufstellen

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

Forken Sie das Repository
Erstellen eines Feature-Zweigs
Nehmen Sie Ihre Änderungen vor
Fügen Sie gegebenenfalls Tests hinzu
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

trykittai-mcp-server