Whodis MCP-сервер

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

Обзор

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

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

Функции

Проверка доступности доменов : использует библиотеку whoiser для выполнения поиска в WHOIS и определения того, доступны ли домены или зарегистрированы.
Интеграция инструмента MCP : предоставляет инструмент check-domain-availability для клиентов MCP (например, помощников на основе искусственного интеллекта).
Интерфейс CLI : включает интерфейс командной строки ( whodis-mcp-server check-domain-availability ... ) для непосредственного использования и тестирования.
Структурированное ведение журнала : обеспечивает подробное ведение журнала для отладки и мониторинга.
Настраиваемый : поддерживает настройку через переменные среды или файлы .env .

Начиная

Предпосылки

Node.js (>=18.x): Загрузить
Git : для контроля версий

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

# Clone the repository
git clone https://github.com/vinsidious/whodis-mcp-server.git
cd whodis-mcp-server

# Install dependencies
npm install

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

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

npm run dev:server

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

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

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

# Using CLI in development mode
npm run dev:cli -- check-domain-availability example.com non-existent-domain-12345.org

# Or run the built version
npm run start:cli -- check-domain-availability google.com my-unique-idea.dev

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

Архитектура

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

src/
├── cli/              # Command-line interface logic
├── controllers/      # Business logic for domain checks
├── services/         # Interaction with the whoiser library
├── tools/            # MCP tool definition and argument validation
├── types/            # Shared type definitions
├── utils/            # Shared utilities (logging, errors, etc.)
└── index.ts          # Main entry point for server and CLI

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

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

# Start MCP server in development mode (with MCP Inspector)
npm run dev:server

# Run CLI commands in development mode
npm run dev:cli -- check-domain-availability <domains...>

# Build the project for production
npm run build

# Start MCP server in production mode (requires MCP client)
npm run start:server

# Run CLI commands using the production build
npm run start:cli -- check-domain-availability <domains...>

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

# Run all tests
npm test

# Generate test coverage report
npm run test:coverage

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

# Lint code
npm run lint

# Format code with Prettier
npm run format

Инструмент 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, чтобы протестировать инструмент и просмотреть сведения о запросе/ответе:

Запустите npm run dev:server
Откройте http://localhost:5173 в вашем браузере.
Используйте пользовательский интерфейс для вызова инструмента check-domain-availability .

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

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

# Set environment variable
DEBUG=true npm run dev:server

# Or set DEBUG=true in your .env file

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

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

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

Убедитесь, что изменения зафиксированы и следуют общепринятым сообщениям о фиксации (например, feat: , fix: , chore: ).
Перенесите изменения в main ветку.
Рабочий процесс ci-semantic-release.yml автоматически соберет, протестирует, версионирует и опубликует пакет в npm.

Лицензия

Лицензия ISC

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Сервер Model Context Protocol, позволяющий помощникам с искусственным интеллектом проверять доступность доменных имен с помощью поиска WHOIS.

Related MCP Servers

Whois MCP
bharathvaj-ganesan
A
security
A
license
A
quality
A Model Context Protocol server that allows AI agents to perform WHOIS lookups, enabling users to directly ask the AI about domain availability, ownership, registration details, and other domain information.
Last updated -
4
2,853
30
JavaScript
MIT License
WebSearch-MCP
mnhlt
A
security
F
license
A
quality
A Model Context Protocol server that enables AI assistants to perform real-time web searches, retrieving up-to-date information from the internet via a Crawler API.
Last updated -
1
297
14
JavaScript
MCP-Censys
nickpending
-
security
F
license
-
quality
A Model Context Protocol server that enables natural language querying of the Censys Search API for domain, IP, and FQDN reconnaissance, providing information about hosts, DNS, certificates, and services in real-time.
Last updated -
3
Python
MCP Advisor
istarwyh
A
security
A
license
A
quality
A discovery and recommendation service that helps AI assistants find Model Context Protocol servers based on natural language queries.
Last updated -
445
53
TypeScript
MIT License

View all related MCP servers

Whodis MCP Server