Whodis MCP-сервер

Этот проект предоставляет сервер Model Context Protocol (MCP), специально разработанный для проверки доступности доменных имен с использованием поиска WHOIS. Он позволяет помощникам ИИ или другим инструментам интегрировать проверки доступности доменов в свои рабочие процессы.

Обзор

Что такое МКП?

Model Context Protocol (MCP) — открытый стандарт, позволяющий системам ИИ безопасно и контекстно подключаться к внешним инструментам и источникам данных. Этот сервер реализует стандарт MCP для предоставления информации о доступности домена.

Related MCP server: WebSearch-MCP

Функции

• Проверка доступности доменов : использует библиотеку whoiser для выполнения поиска в WHOIS и определения того, доступны ли домены или зарегистрированы.

• Интеграция инструмента MCP : предоставляет инструмент check-domain-availability для клиентов MCP (например, помощников на основе искусственного интеллекта).

• Интерфейс CLI : включает интерфейс командной строки ( whodis-mcp-server check-domain-availability ... ) для непосредственного использования и тестирования.

• Структурированное ведение журнала : обеспечивает подробное ведение журнала для отладки и мониторинга.

• Настраиваемый : поддерживает настройку через переменные среды или файлы .env .

Начиная

Предпосылки

• Node.js (>=18.x): Загрузить

• Git : для контроля версий

Шаг 1: Клонирование и установка

Шаг 2: Запуск сервера разработки

Запустите сервер в режиме разработки, чтобы взаимодействовать с ним через MCP Inspector:

Это запустит сервер MCP и включит MCP Inspector по адресу http://localhost:5173 , где вы можете протестировать инструмент check-domain-availability .

Шаг 3: Тестирование инструмента через CLI

Запустите проверку доступности домена прямо из командной строки:

CLI выведет объект JSON, содержащий available и unavailable массивы.

Архитектура

Этот сервер имеет многоуровневую архитектуру:

Руководство по разработке

Сценарии разработки

Тестирование

Качество кода

Инструмент MCP: check-domain-availability

• НАЗНАЧЕНИЕ : Проверка доступности одного или нескольких доменных имен.

• ВХОД : Массив доменных имен.

  { "domains": ["example.com", "another-domain.net"] }

• ВЫХОД : Объект JSON, содержащий два массива: available (домены, которые кажутся незарегистрированными) и unavailable (домены, которые кажутся зарегистрированными).

  { "available": ["likely-available-domain123.xyz"], "unavailable": ["google.com"] }

  Примечание : проверки доступности зависят от ответов сервера WHOIS и могут быть не на 100% точными для всех TLD или из-за временных проблем с сетью. Домены, в которых поиск не удался, опущены.

• КОГДА ИСПОЛЬЗОВАТЬ : Используйте этот инструмент, когда вам нужно определить, могут ли быть зарегистрированы определенные доменные имена.

Отладка

Инспектор МКП

Откройте визуальный MCP Inspector, чтобы протестировать инструмент и просмотреть сведения о запросе/ответе:

1. Запустите npm run dev:server

2. Откройте http://localhost:5173 в вашем браузере.

3. Используйте пользовательский интерфейс для вызова инструмента check-domain-availability .

Журналы сервера

Включите журналы отладки для получения подробной информации:

Журналы также сохраняются в файлах ~/.mcp/data/whodis-mcp-server.*.log .

Издательский

Чтобы опубликовать обновления в npm:

1. Убедитесь, что изменения зафиксированы и следуют общепринятым сообщениям о фиксации (например, feat: , fix: , chore: ).

2. Перенесите изменения в main ветку.

3. Рабочий процесс ci-semantic-release.yml автоматически соберет, протестирует, версионирует и опубликует пакет в npm.

Лицензия

Лицензия ISC