MCP Domain Availability Checker

Verifique a disponibilidade de nomes de domínio em mais de 50 TLDs populares usando verificação DNS e WHOIS.

Documentação

MCP Domain Availability Checker

Uma integração Model Context Protocol (MCP) que fornece ao Claude Desktop verificação de disponibilidade de domínios em TLDs populares.

Recursos

Verificação de Disponibilidade de Domínios
- Verifique a disponibilidade em mais de 50 extensões de TLD populares
- Suporte para TLDs populares (.com, .io, .ai), de países (.us, .uk, .de) e novos TLDs (.app, .dev, .tech)
- Verificação autoritativa via RDAP, o protocolo que substituiu o WHOIS
- Fallback para WHOIS e DNS nos poucos TLDs que não publicam serviço RDAP
- Sugestões inteligentes de TLDs organizadas por popularidade
Capacidades de Busca
- Verifique domínios específicos com correspondência exata de TLD
- Verificação em lote em extensões suportadas para um determinado nome
- Processamento paralelo para consultas de domínio mais rápidas
- Resultados organizados por categorias de TLD
Integração MCP
- Configuração fácil com gerenciamento de pacotes uvx
- Integração perfeita com o Claude Desktop
- Atualizações de status de disponibilidade em tempo real
- Métricas de desempenho e informações de tempo
Recursos de Assistente de IA
- Consultas de domínio em linguagem natural através do Claude
- Fluxos de trabalho automatizados de sugestão de domínios
- Recomendações inteligentes baseadas na disponibilidade

Demonstração

Carimbos de tempo:

Clique em qualquer carimbo de tempo para pular para aquela seção do vídeo

00:00 - Verificando a disponibilidade de google.com
Testando um domínio premium conhecido para demonstrar a funcionalidade de verificação de domínios e sugestões alternativas de TLD.

00:20 - Testando myawesomesite.com
Verificando a disponibilidade de um nome de domínio personalizado e explorando opções alternativas de extensão.

00:40 - Verificando techstartup2026.io
Explorando opções de domínio para startups de tecnologia e verificando a disponibilidade em múltiplas extensões de TLD.

01:00 - Analisando o domínio aitools
Verificando domínios competitivos da indústria de IA e analisando a disponibilidade no mercado para nomeação de startups.

Requisitos

Python 3.10 ou superior (3.12 recomendado)
Claude Desktop
Gerenciador de pacotes uv

Instalação de Dependências

Instale o gerenciador de pacotes uv usando um destes métodos:

Instalador oficial (recomendado):

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

Homebrew (macOS/Linux):

brew install uv

Instalar Homebrew (se necessário):

Visite https://brew.sh para instruções de instalação em todos os sistemas operacionais
Ou execute: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

O servidor MCP gerencia automaticamente as dependências Python através do uvx.

Instalação

Instalação Sem Clone (Recomendado)

O MCP Domain Availability Checker suporta instalação direta sem clonar repositórios, usando uvx para gerenciamento de pacotes.

Configuração

O arquivo de configuração do Claude Desktop está localizado em:

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

Edite este arquivo para adicionar a configuração MCP de disponibilidade de domínios:

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

Se você já tiver outros MCPs configurados, basta adicionar a seção "mcp-domain-availability" dentro do 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"
      ]
    }
  }
}

Instalando via Smithery

Para instalar o mcp-domain-availability para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

Para desenvolvimento ou testes locais:

Clone o repositório:

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

Instale as dependências:

uv sync

Execute localmente:

uv run src/mcp_domain_availability/main.py

Implantando com Docker no Google Cloud Run

O servidor MCP suporta dois modos de transporte:

stdio (padrão): Para integração com Claude Desktop via stdin/stdout
sse: Para implantações HTTP/web como Google Cloud Run

Ao implantar no Cloud Run, a variável de ambiente MCP_TRANSPORT deve ser definida como sse.

Pré-requisitos:

Google Cloud SDK instalado e autenticado (gcloud auth login)
Docker instalado e em execução
Um projeto Google Cloud com as APIs Cloud Run e Container Registry habilitadas

Usando o Script de Implantação

A maneira mais fácil de implantar é usar o script deploy.sh.

Edite o script: Abra deploy.sh e substitua ... pelo seu PROJECT_ID do Google Cloud. Você também pode alterar o REGION se necessário.
Execute o script: Torne o script executável e execute-o.

    chmod +x deploy.sh
    ./deploy.sh

O script criará a imagem Docker, enviará para o Google Container Registry e implantará no Cloud Run com `MCP_TRANSPORT=sse`.

Implantação Manual

Alternativamente, você pode executar os comandos manualmente.

Defina as variáveis de ambiente:

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

Crie e envie a imagem Docker:

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

Implante no 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 com Claude Desktop, nenhuma variável de ambiente é necessária. O servidor usa por padrão o modo de transporte stdio.

Como Funciona

A ICANN aposentou o WHOIS como protocolo obrigatório de dados de registro em janeiro de 2025 em favor do RDAP (RFC 7482/9082), então o RDAP é a fonte primária aqui. Ele é inequívoco: o serviço RDAP de um registro responde 404 para um domínio não registrado e 200 para um registrado.

RDAP — o serviço RDAP do próprio registro, descoberto através do registro de bootstrap da IANA (cerca de 1.200 TLDs). Isso é autoritativo.
WHOIS — apenas para TLDs sem serviço RDAP (.io, .co, .me, .de, .es e alguns outros ccTLDs). O servidor WHOIS do registro é encontrado via referência da IANA e consultado diretamente na porta 43; apenas as primeiras linhas da resposta são interpretadas.
DNS — um nome que resolve está definitivamente registrado.

Cada domínio retorna um de três status:

Status	Significado
`available`	O registro confirmou que não há registro
`taken`	O registro confirmou um registro, ou o nome resolve no DNS
`undetermined`	Nenhuma fonte autoritativa respondeu. Não é o mesmo que disponível

undetermined existe porque a versão anterior reportava um domínio como disponível sempre que uma consulta WHOIS gerava um erro — incluindo quando a máquina não tinha o binário whois instalado, caso em que todo domínio parecia livre. Um resultado em que você não pode confiar agora é rotulado como tal.

Os domínios são verificados simultaneamente, limitados a 10 em andamento para permanecer dentro dos limites de taxa dos registros.

Ferramentas Disponíveis

Alterado na versão 0.5.0: o sinalizador --domain não é mais necessário — peça um domínio em linguagem simples. O sinalizador ainda é aceito para que prompts existentes continuem funcionando. A verificação em lote de TLDs foi movida para sua própria ferramenta, então perguntar sobre um domínio não dispara mais ~95 consultas.

Nome da Ferramenta	Descrição	Parâmetros
`check_domain`	Verifica um domínio específico	`domain`: ex. `mysite.com`. Um nome simples sem TLD é verificado nos TLDs populares
`suggest_domains`	Verifica um nome em vários TLDs	`name`: ex. `mysite`; `category`: `popular` (padrão, 12), `country` (36), `new` (49) ou `all` (~95)

Categorias de TLD Suportadas

TLDs Populares (12)

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

TLDs de Países (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

Novos TLDs

tech, online, site, website, store, shop, cloud, digital, blog, news e mais.

Exemplo de Uso

Aqui estão exemplos de como usar o MCP Domain Availability Checker com o Claude:

Verificação de Domínio Único

Is mysite.com available?

Pesquisa de Nome de Domínio

Check "startup" across all TLDs

Verificação de Domínio Específico

Is awesome.io taken?

Formato de Saída

A ferramenta fornece resultados abrangentes incluindo:

Domínio Solicitado: Status do domínio exato consultado (se um TLD específico foi fornecido)
Domínios Disponíveis: Confirmados como não registrados, ordenados alfabeticamente
Domínios Indisponíveis: Confirmados como registrados
Domínios Indeterminados: Sem resposta autoritativa, com o motivo
Estatísticas Resumidas: Distribuição por categorias de TLD (Populares, Países, Novos TLDs)
Métricas de Desempenho: Duração da verificação e qual fonte respondeu (rdap, whois ou dns)

Desenvolvimento

Execute a suíte de testes offline (sem necessidade de rede):

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

Verifique um domínio pela linha de comando:

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

Solução de Problemas

Erro "Servidor desconectado"

Se você vir erros de conexão no Claude Desktop:

Verifique a instalação do uvx:
- Execute uvx --version para garantir que o uvx está instalado corretamente
- Reinstale o uv se necessário: curl -LsSf https://astral.sh/uv/install.sh | sh
Verifique a versão do Python:
- Garanta que Python 3.10+ está disponível: python3 --version

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

A versão 2.0 do SDK Python MCP removeu mcp.server.fastmcp. Versões deste servidor anteriores à 0.5.0 o importavam sem limitar a versão do SDK, então qualquer instalação nova instalava o SDK 2.x e falhava na inicialização. A versão 0.5.0 é escrita para o SDK 2.x. Se você ainda vir o erro, o uv está executando uma cópia em cache do código antigo:

Atualize a instalação em cache:
- Execute uvx --refresh --from git+https://github.com/imprvhub/mcp-domain-availability mcp-domain-availability
- Se você instalou como uma ferramenta persistente, execute uv tool upgrade mcp-domain-availability
Remova a solução alternativa antiga: se você adicionou "--with", "mcp<2.0.0" à configuração do seu cliente, exclua-a. A versão 0.5.0 requer o SDK 2.x e não iniciará com essa restrição.

Problemas de resolução de DNS

Se as verificações de domínio estiverem falhando:

Conectividade de rede:
- Verifique se a conexão com a internet está estável
- Verifique se os servidores DNS estão acessíveis
Limite de taxa:
- Verificações em lote grandes podem atingir limites de taxa dos serviços DNS/WHOIS
- A ferramenta usa um semáforo para limitar solicitações simultâneas a 20

Problemas de configuração

Se o servidor MCP não estiver iniciando:

Verifique a sintaxe da configuração:
- Garanta que a sintaxe JSON é válida em claude_desktop_config.json
- Verifique se todos os colchetes e aspas estão corretamente correspondidos
Reinicie o Claude Desktop:
- Feche e reinicie o Claude Desktop após alterações de configuração

Desenvolvimento

Estrutura do Projeto

main.py: Ponto de entrada principal com servidor MCP e lógica de verificação de domínios
Funções de verificação de domínios com métodos de fallback DNS, WHOIS e socket
Gerenciamento de TLDs com listas categorizadas
Processamento assíncrono para verificações paralelas de domínios

Compilação

uv build

Testes

uv run pytest

Desenvolvimento Local

uv run main.py

Considerações de Segurança

O MCP Domain Availability Checker faz solicitações de rede externas para servidores DNS e serviços WHOIS. Os usuários devem estar cientes de que:

Consultas de domínio podem ser registradas por provedores de DNS
Consultas WHOIS são tipicamente registradas e podem ter limite de taxa
Nenhuma informação pessoal é transmitida além dos nomes de domínio sendo verificados
Todas as consultas são somente leitura e não modificam nenhum sistema externo

Contribuindo

Contribuições são bem-vindas! Áreas para melhoria incluem:

Adicionar suporte para categorias adicionais de TLD
Implementar mecanismos de cache para consultas repetidas mais rápidas
Melhorar o parsing WHOIS para informações de domínio mais detalhadas
Melhorar o tratamento de erros e mecanismos de nova tentativa

Licença

Este projeto é licenciado sob a Mozilla Public License 2.0 — consulte o arquivo LICENSE para detalhes.

MCP Domain Availability Checker

Documentação