Servidor MCP de Whodis

Este proyecto proporciona un servidor de Protocolo de Contexto de Modelo (MCP) diseñado específicamente para comprobar la disponibilidad de nombres de dominio mediante búsquedas WHOIS. Permite a los asistentes de IA u otras herramientas integrar la comprobación de la disponibilidad de dominios en sus flujos de trabajo.

Descripción general

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los sistemas de IA conectarse de forma segura y contextual con herramientas y fuentes de datos externas. Este servidor implementa el estándar MCP para proporcionar información sobre la disponibilidad del dominio.

Características

Comprobaciones de disponibilidad de dominio : utiliza la biblioteca whoiser para realizar búsquedas WHOIS y determinar si los dominios parecen estar disponibles o registrados.
Integración de herramientas MCP : expone una herramienta de check-domain-availability para clientes MCP (como asistentes de IA).
Interfaz CLI : incluye una interfaz de línea de comandos ( whodis-mcp-server check-domain-availability ... ) para uso directo y pruebas.
Registro estructurado : proporciona un registro detallado para la depuración y la supervisión.
Configurable : admite la configuración a través de variables de entorno o archivos .env .

Empezando

Prerrequisitos

Node.js (>=18.x): Descargar
Git : para el control de versiones

Paso 1: Clonar e instalar

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

# Install dependencies
npm install

Paso 2: Ejecutar el servidor de desarrollo

Inicie el servidor en modo de desarrollo para interactuar con él a través del Inspector MCP:

npm run dev:server

Esto inicia el servidor MCP y habilita el Inspector MCP en http://localhost:5173 , donde puede probar la herramienta de check-domain-availability .

Paso 3: Pruebe la herramienta a través de CLI

Ejecute el verificador de disponibilidad del dominio directamente desde la línea de comandos:

# 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

La CLI generará un objeto JSON que contiene matrices available y unavailable .

Arquitectura

Este servidor sigue una arquitectura en capas:

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

Guía de desarrollo

Scripts de desarrollo

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

Pruebas

# Run all tests
npm test

# Generate test coverage report
npm run test:coverage

Calidad del código

# Lint code
npm run lint

# Format code with Prettier
npm run format

Herramienta MCP: `check-domain-availability`

PROPÓSITO : Verifica la disponibilidad de uno o más nombres de dominio.
ENTRADA : Una matriz de nombres de dominio.
{ "domains": ["example.com", "another-domain.net"] }
SALIDA : Un objeto JSON que contiene dos matrices: available (dominios que parecen no estar registrados) y unavailable (dominios que parecen estar registrados).
{ "available": ["likely-available-domain123.xyz"], "unavailable": ["google.com"] }
Nota : Las comprobaciones de disponibilidad dependen de las respuestas del servidor WHOIS y podrían no ser 100 % precisas para todos los TLD o debido a problemas temporales de red. Se omiten los dominios con errores de búsqueda.
CUÁNDO USARLO : Utilice esta herramienta cuando necesite determinar si es posible registrar nombres de dominio específicos.

Depuración

Inspector de MCP

Acceda al Inspector visual de MCP para probar la herramienta y ver los detalles de la solicitud/respuesta:

Ejecutar npm run dev:server
Abra http://localhost:5173 en su navegador
Utilice la interfaz de usuario para llamar a la herramienta de check-domain-availability .

Registros del servidor

Habilitar registros de depuración para obtener una salida detallada:

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

# Or set DEBUG=true in your .env file

Los registros también se guardan en archivos en ~/.mcp/data/whodis-mcp-server.*.log .

Publicación

Para publicar actualizaciones en npm:

Asegúrese de que los cambios se confirmen y sigan los mensajes de confirmación convencionales (por ejemplo, feat: , fix: , chore: ).
Enviar cambios a la rama main .
El flujo de trabajo ci-semantic-release.yml creará, probará, versionará y publicará automáticamente el paquete en npm.

Licencia

Licencia ISC

This server cannot be installed

security - not tested

license - not found

quality - not tested

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.

Un servidor de protocolo de contexto modelo que permite a los asistentes de IA comprobar la disponibilidad de nombres de dominio mediante búsquedas WHOIS.

Related MCP Servers

ServiceNow MCP Server
michaelbuckner
-
security
A
license
-
quality
A Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.
Last updated -
9
Python
MIT License
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
10
1
JavaScript
MIT License
Notion MCP Server
emmanuelsystems
-
security
F
license
-
quality
A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
Last updated -
275
JavaScript
Whois MCP
modelcontextprotocol-servers
-
security
F
license
-
quality
Enables AI agents to perform WHOIS lookups to retrieve domain registration details, including ownership, registration dates, and availability status without requiring browser searches.
Last updated -
2
2
JavaScript

View all related MCP servers

Whodis MCP Server