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: Domain-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

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

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:

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

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