MCP Domain Availability Checker

Verifica la disponibilidad de nombres de dominio en más de 50 TLDs populares mediante verificación DNS y WHOIS.

Documentación

MCP Domain Availability Checker

Una integración del Protocolo de Contexto de Modelo (MCP) que proporciona a Claude Desktop verificación de disponibilidad de dominios en TLDs populares.

Características

Verificación de Disponibilidad de Dominios
- Verifica disponibilidad en más de 50 extensiones TLD populares
- Soporte para TLDs populares (.com, .io, .ai), de país (.us, .uk, .de) y nuevos TLDs (.app, .dev, .tech)
- Verificación autoritativa mediante RDAP, el protocolo que reemplazó a WHOIS
- Respaldo de WHOIS y DNS para los pocos TLDs que no publican servicio RDAP
- Sugerencias inteligentes de TLDs organizadas por popularidad
Capacidades de Búsqueda
- Verifica dominios específicos con coincidencia exacta de TLD
- Verificación masiva en extensiones compatibles para un nombre dado
- Procesamiento paralelo para consultas de dominios más rápidas
- Resultados organizados por categorías de TLD
Integración MCP
- Configuración sencilla con gestión de paquetes uvx
- Integración perfecta con Claude Desktop
- Actualizaciones de estado de disponibilidad en tiempo real
- Métricas de rendimiento e información de tiempos
Características del Asistente de IA
- Consultas de dominios en lenguaje natural a través de Claude
- Flujos de trabajo automatizados de sugerencias de dominios
- Recomendaciones inteligentes basadas en disponibilidad

Demostración

Marcas de tiempo:

Haz clic en cualquier marca de tiempo para saltar a esa sección del video

00:00 - Verificando disponibilidad de google.com
Probando un dominio premium conocido para demostrar la funcionalidad de verificación de dominios y las sugerencias alternativas de TLD.

00:20 - Probando myawesomesite.com
Verificando disponibilidad de un nombre de dominio personalizado y explorando opciones de extensiones alternativas.

00:40 - Verificando techstartup2026.io
Explorando opciones de dominios para startups tecnológicas y verificando disponibilidad en múltiples extensiones TLD.

01:00 - Analizando el dominio aitools
Verificando dominios competitivos de la industria de IA y analizando la disponibilidad en el mercado para nombres de startups.

Requisitos

Python 3.10 o superior (se recomienda 3.12)
Claude Desktop
Gestor de paquetes uv

Instalación de Dependencias

Instala el gestor de paquetes uv usando uno de estos métodos:

Instalador oficial (recomendado):

curl -LsSf https://astral.sh/uv/install.sh | sh

Homebrew (macOS/Linux):

brew install uv

Instalar Homebrew (si es necesario):

Visita https://brew.sh para instrucciones de instalación en todos los sistemas operativos
O ejecuta: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

El servidor MCP gestiona automáticamente las dependencias de Python mediante uvx.

Instalación

Instalación sin Clonar (Recomendado)

El MCP Domain Availability Checker admite instalación directa sin clonar repositorios, utilizando uvx para la gestión de paquetes.

Configuración

El archivo de configuración de Claude Desktop se encuentra en:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Edita este archivo para añadir la configuración MCP de disponibilidad de dominios:

{
  "mcpServers": {
    "mcp-domain-availability": {
      "command": "uvx",
      "args": [
        "--python=3.12",
        "--from",
        "git+https://github.com/imprvhub/mcp-domain-availability",
        "mcp-domain-availability"
      ]
    }
  }
}

Si ya tienes otros MCPs configurados, simplemente añade la sección "mcp-domain-availability" dentro del objeto "mcpServers":

{
  "mcpServers": {
    "otherMcp": {
      "command": "...",
      "args": ["..."]
    },
    "mcp-domain-availability": {
      "command": "uvx",
      "args": [
        "--python=3.12",
        "--from",
        "git+https://github.com/imprvhub/mcp-domain-availability",
        "mcp-domain-availability"
      ]
    }
  }
}

Instalación mediante Smithery

Para instalar mcp-domain-availability para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli@latest mcp add imprvhub/mcp-domain-availability --client claude

Instalación Manual

Para desarrollo o pruebas locales:

Clona el repositorio:

git clone https://github.com/imprvhub/mcp-domain-availability
cd mcp-domain-availability

Instala las dependencias:

uv sync

Ejecuta localmente:

uv run src/mcp_domain_availability/main.py

Despliegue con Docker en Google Cloud Run

El servidor MCP admite dos modos de transporte:

stdio (predeterminado): Para integración con Claude Desktop mediante stdin/stdout
sse: Para despliegues HTTP/web como Google Cloud Run

Al desplegar en Cloud Run, la variable de entorno MCP_TRANSPORT debe establecerse en sse.

Requisitos previos:

Google Cloud SDK instalado y autenticado (gcloud auth login)
Docker instalado y en ejecución
Un proyecto de Google Cloud con las APIs de Cloud Run y Container Registry habilitadas

Uso del Script de Despliegue

La forma más sencilla de desplegar es usar el script deploy.sh.

Edita el script: Abre deploy.sh y reemplaza ... con tu PROJECT_ID de Google Cloud. También puedes cambiar el REGION si es necesario.
Ejecuta el script: Haz que el script sea ejecutable y ejecútalo.

    chmod +x deploy.sh
    ./deploy.sh

El script construirá la imagen Docker, la enviará a Google Container Registry y la desplegará en Cloud Run con `MCP_TRANSPORT=sse`.

Despliegue Manual

Alternativamente, puedes ejecutar los comandos manualmente.

Establece las variables de entorno:

    export PROJECT_ID="<YOUR_PROJECT_ID>"
    export REGION="<YOUR_REGION>"
    export IMAGE="gcr.io/$PROJECT_ID/mcp-domain-availability:latest"

Construye y envía la imagen Docker:

    docker buildx build --platform linux/amd64 -t $IMAGE --push .

Despliega en Google Cloud Run:

    gcloud run deploy mcp-domain-availability \
      --image $IMAGE \
      --region $REGION \
      --platform managed \
      --allow-unauthenticated \
      --port 8080 \
      --set-env-vars MCP_TRANSPORT=sse \
      --project $PROJECT_ID

Nota: Para uso local con Claude Desktop, no se necesitan variables de entorno. El servidor usa por defecto el modo de transporte stdio.

Cómo Funciona

ICANN retiró WHOIS como protocolo obligatorio de datos de registro en enero de 2025 en favor de RDAP (RFC 7482/9082), por lo que RDAP es la fuente principal aquí. Es inequívoco: el servicio RDAP de un registro responde 404 para un dominio no registrado y 200 para uno registrado.

RDAP — el propio servicio RDAP del registro, descubierto mediante el registro bootstrap de IANA (aproximadamente 1,200 TLDs). Esto es autoritativo.
WHOIS — solo para TLDs sin servicio RDAP (.io, .co, .me, .de, .es y algunos otros ccTLDs). El servidor WHOIS del registro se encuentra mediante la referencia de IANA y se consulta directamente a través del puerto 43; solo se interpretan las primeras líneas de la respuesta.
DNS — un nombre que se resuelve está definitivamente registrado.

Cada dominio devuelve uno de tres estados:

Estado	Significado
`available`	El registro confirmó que no hay registro
`taken`	El registro confirmó un registro, o el nombre se resuelve en DNS
`undetermined`	Ninguna fuente autoritativa respondió. No es lo mismo que disponible

undetermined existe porque la versión anterior informaba un dominio como disponible cada vez que una consulta WHOIS generaba un error — incluso cuando la máquina no tenía instalado el binario whois, en cuyo caso cada dominio parecía libre. Un resultado en el que no puedes confiar ahora se etiqueta como tal.

Los dominios se verifican de forma concurrente, con un máximo de 10 en vuelo para mantenerse dentro de los límites de tasa de los registros.

Herramientas Disponibles

Cambiado en 0.5.0: la bandera --domain ya no es necesaria — solicita un dominio en lenguaje natural. La bandera aún se acepta para que los prompts existentes sigan funcionando. La verificación masiva de TLD se movió a su propia herramienta, por lo que preguntar por un dominio ya no dispara ~95 consultas.

Nombre de la Herramienta	Descripción	Parámetros
`check_domain`	Verifica un dominio específico	`domain`: p. ej. `mysite.com`. Un nombre sin TLD se verifica en los TLDs populares
`suggest_domains`	Verifica un nombre en muchos TLDs	`name`: p. ej. `mysite`; `category`: `popular` (predeterminado, 12), `country` (36), `new` (49) o `all` (~95)

Categorías de TLD Compatibles

TLDs Populares (12)

com, net, org, io, ai, app, dev, co, xyz, me, info, biz

TLDs de País (36)

us, uk, ca, au, de, fr, it, es, nl, jp, kr, cn, in, br, mx, ar, cl, pe, ru, pl, cz, ch, at, se, no, dk, fi, be, pt, gr, tr, za, eg, ma, ng, ke

Nuevos TLDs

tech, online, site, website, store, shop, cloud, digital, blog, news y más.

Ejemplo de Uso

Aquí hay ejemplos de cómo usar el MCP Domain Availability Checker con Claude:

Verificación de Dominio Único

Is mysite.com available?

Investigación de Nombres de Dominio

Check "startup" across all TLDs

Verificación de Dominio Específico

Is awesome.io taken?

Formato de Salida

La herramienta proporciona resultados completos que incluyen:

Dominio Solicitado: Estado del dominio exacto consultado (si se proporcionó un TLD específico)
Dominios Disponibles: Confirmados como no registrados, ordenados alfabéticamente
Dominios No Disponibles: Confirmados como registrados
Dominios Indeterminados: Sin respuesta autoritativa, con el motivo
Estadísticas Resumidas: Desglose por categorías de TLD (Populares, de País, Nuevos TLDs)
Métricas de Rendimiento: Duración de la verificación y qué fuente respondió (rdap, whois o dns)

Desarrollo

Ejecuta la suite de pruebas sin conexión (no requiere red):

uv sync
uv run python -m unittest discover -s tests -v

Verifica un dominio desde la línea de comandos:

uv run mcp-domain-availability-cli example.com
uv run mcp-domain-availability-cli mysite popular

Solución de Problemas

Error de "Servidor desconectado"

Si ves errores de conexión en Claude Desktop:

Verifica la instalación de uvx:
- Ejecuta uvx --version para asegurarte de que uvx esté instalado correctamente
- Reinstala uv si es necesario: curl -LsSf https://astral.sh/uv/install.sh | sh
Verifica la versión de Python:
- Asegúrate de que Python 3.10+ esté disponible: python3 --version

"ModuleNotFoundError: No module named 'mcp.server.fastmcp'"

La versión 2.0 del SDK de Python de MCP eliminó mcp.server.fastmcp. Las versiones de este servidor anteriores a 0.5.0 lo importaban sin limitar la versión del SDK, por lo que cualquier instalación nueva tomaba el SDK 2.x y fallaba al iniciar. 0.5.0 está escrito para SDK 2.x. Si aún ves el error, uv está ejecutando una copia en caché del código antiguo:

Actualiza la instalación en caché:
- Ejecuta uvx --refresh --from git+https://github.com/imprvhub/mcp-domain-availability mcp-domain-availability
- Si lo instalaste como herramienta persistente, ejecuta uv tool upgrade mcp-domain-availability
Elimina la solución temporal antigua: si añadiste "--with", "mcp<2.0.0" a tu configuración de cliente, elimínala. 0.5.0 requiere SDK 2.x y no se iniciará con esa fijación.

Problemas de resolución DNS

Si las verificaciones de dominios están fallando:

Conectividad de red:
- Verifica que la conexión a internet sea estable
- Comprueba si los servidores DNS son accesibles
Límite de tasa:
- Las verificaciones masivas grandes pueden alcanzar límites de tasa de los servicios DNS/WHOIS
- La herramienta usa un semáforo para limitar las solicitudes concurrentes a 20

Problemas de configuración

Si el servidor MCP no se inicia:

Verifica la sintaxis de configuración:
- Asegúrate de que la sintaxis JSON sea válida en claude_desktop_config.json
- Comprueba que todos los corchetes y comillas estén correctamente emparejados
Reinicia Claude Desktop:
- Cierra y reinicia Claude Desktop después de los cambios de configuración

Desarrollo

Estructura del Proyecto

main.py: Punto de entrada principal con el servidor MCP y la lógica de verificación de dominios
Funciones de verificación de dominios con métodos de respaldo DNS, WHOIS y socket
Gestión de TLDs con listas categorizadas
Procesamiento asíncrono para verificaciones paralelas de dominios

Compilación

uv build

Pruebas

uv run pytest

Desarrollo Local

uv run main.py

Consideraciones de Seguridad

El MCP Domain Availability Checker realiza solicitudes de red externas a servidores DNS y servicios WHOIS. Los usuarios deben ser conscientes de que:

Las consultas de dominios pueden ser registradas por los proveedores de DNS
Las consultas WHOIS generalmente se registran y pueden estar sujetas a límites de tasa
No se transmite información personal más allá de los nombres de dominio verificados
Todas las consultas son de solo lectura y no modifican ningún sistema externo

Contribuciones

¡Las contribuciones son bienvenidas! Las áreas de mejora incluyen:

Añadir soporte para categorías adicionales de TLD
Implementar mecanismos de caché para consultas repetidas más rápidas
Mejorar el análisis WHOIS para información de dominios más detallada
Mejorar el manejo de errores y los mecanismos de reintento

Licencia

Este proyecto está licenciado bajo la Mozilla Public License 2.0 — consulta el archivo LICENSE para más detalles.

MCP Domain Availability Checker

Documentación