попробуйтеkittai-mcp-сервер

ПопробуйтеKitt.ai mcp-сервер

Сервер FastMCP (Model Context Protocol), который обеспечивает возможности проверки и поиска электронной почты с использованием API TryKitt.ai . Этот сервер позволяет помощникам ИИ находить и проверять адреса электронной почты B2B с высокой точностью и низкими показателями отказов.

Функции

Проверка электронной почты : проверка адресов электронной почты с помощью расширенной проверки SMTP и всеобъемлющей проверки
Поиск адресов электронной почты : поиск адресов электронной почты отдельных лиц по их имени и домену компании.
Управление заданиями : отслеживание и мониторинг проверки электронной почты/поиска заданий
Обработка в реальном времени : получайте немедленные результаты операций с электронной почтой
Высокая точность : использует передовые алгоритмы проверки TryKitt.ai с показателем отказов <0,1%

Установка

Клонируйте этот репозиторий:

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

Инициализируйте новую среду Python с помощью 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

Установите зависимости с помощью uv:

# Using uv (recommended)
uv sync

Настраивать

Получите свой API-ключ TryKitt.ai:
- Посетите TryKitt.ai
- Зарегистрируйте учетную запись
- Перейдите в настройки API, чтобы получить свой ключ API.
Установите свой ключ API как переменную среды:

export TRYKITT_API_KEY="your_api_key_here"

Или создайте файл .env в корне проекта:

TRYKITT_API_KEY=your_api_key_here

Использование

Запуск сервера

Запустите сервер FastMCP:

python server.py

Сервер запустится и будет доступен для MCP-подключений.

Добавление в MCP-клиенты

Чтобы использовать этот сервер с клиентами, совместимыми с MCP, вам необходимо настроить клиент для подключения к этому серверу.

Клод Десктоп

Добавьте следующую конфигурацию в файл конфигурации 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"
      }
    }
  }
}

Другие клиенты MCP

Для других MCP-совместимых клиентов настройте их для подключения к:

Команда : python
Аргументы : ["/path/to/your/trykittai-mcp-server/server.py"]
Переменные среды : TRYKITT_API_KEY=your_api_key_here

Использование с УФ

Если вы используете uv, вы также можете запустить сервер с помощью:

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

Примечание : замените /path/to/your/trykittai-mcp-server на фактический абсолютный путь к каталогу вашего проекта, а your_api_key_here — на фактический ключ API TryKitt.ai.

Доступные инструменты

1. Проверка электронной почты ( `verify_email_send` )

Проверьте, действителен ли адрес электронной почты и возможна ли доставка писем.

Параметры:

email (обязательно): Адрес электронной почты для проверки
custom_data (необязательно): пользовательские данные для связи с запросом.

Пример:

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

2. Поиск электронной почты ( `find_email` )

Найдите адрес электронной почты человека по его имени и домену компании.

Параметры:

full_name (обязательно): Полное имя человека
domain (обязательно): Домен компании или веб-сайт
linkedin_url (необязательно): URL-адрес профиля LinkedIn для большей точности
custom_data (необязательно): пользовательские данные для связи с запросом.

Пример:

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

3. Статус задания ( `get_job_status` )

Проверьте статус ранее отправленной работы.

Параметры:

job_id (обязательно): идентификатор задания для проверки.

Пример:

result = await get_job_status("job_123456")

4. Список вакансий ( `list_jobs` )

Перечислите все задания (Примечание: эта конечная точка может иметь ограниченную доступность).

Пример:

result = await list_jobs()

Формат ответа API

Успешная проверка электронной почты

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

Успешное нахождение электронной почты

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

Обработка ошибок

Сервер обрабатывает различные сценарии ошибок:

Недействительные ключи API
Ограничение скорости
Сетевые тайм-ауты
Недопустимые форматы электронной почты
Ошибки проверки домена

Распространенные ошибки в ответах:

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

Конфигурация

Переменные среды

TRYKITT_API_KEY : Ваш ключ API TryKitt.ai (обязательно)

Конфигурация SSL

Сервер настроен на работу с конечными точками API TryKitt.ai. Проверка SSL в настоящее время отключена для совместимости.

Разработка

Структура проекта

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

Зависимости

fastmcp : фреймворк FastMCP для создания серверов MCP
httpx : Асинхронный HTTP-клиент для API-запросов
pydantic : Проверка данных и управление настройками

О TryKitt.ai

TryKitt.ai — это расширенный сервис проверки и поиска адресов электронной почты, который:

Предоставляет неограниченную бесплатную проверку электронной почты для отдельных пользователей
Достигает показателя отказов <0,1% благодаря расширенной проверке
Работает в 2–5 раз быстрее альтернативных решений
Использует корпоративные серверы идентификации для всеобъемлющей проверки
Обнаруживает изменения в работе и проверяет их на соответствие реальным системам

Узнайте больше на https://trykitt.ai/

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Внося вклад

Форк репозитория
Создать ветку функций
Внесите изменения
Добавьте тесты, если применимо
Отправить запрос на извлечение

Поддерживать

По вопросам, связанным с:

Этот сервер MCP: Открыть проблему в этом репозитории
TryKitt.ai API: свяжитесь со службой поддержки TryKitt.ai
Фреймворк FastMCP: ознакомьтесь с документацией FastMCP

Журнал изменений

версия 1.0.0

Первоначальный выпуск с возможностью проверки и поиска по электронной почте
Отслеживание статуса задания
Поддержка обработки в реальном времени
Интеграция FastMCP

trykittai-mcp-server