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.

Related MCP server: WebSearch-MCP

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

Paso 2: Ejecutar el servidor de desarrollo

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

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:

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

Arquitectura

Este servidor sigue una arquitectura en capas:

Guía de desarrollo

Scripts de desarrollo

Pruebas

Calidad del código

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:

1. Ejecutar npm run dev:server

2. Abra http://localhost:5173 en su navegador

3. 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:

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

Publicación

Para publicar actualizaciones en npm:

1. Asegúrese de que los cambios se confirmen y sigan los mensajes de confirmación convencionales (por ejemplo, feat: , fix: , chore: ).

2. Enviar cambios a la rama main .

3. El flujo de trabajo ci-semantic-release.yml creará, probará, versionará y publicará automáticamente el paquete en npm.

Licencia

Licencia ISC