Whois MCP

Servidor MCP que realiza consulta whois para domínio, IP, ASN e TLD.

Documentação

Whois MCP

Servidor do Model Context Protocol para consultas whois.

Whois MCP server

Demonstração no Cursor IDE

https://github.com/user-attachments/assets/57a82adc-3f30-453f-aabd-7138c2e6a21d

Demonstração no Claude Desktop

https://github.com/user-attachments/assets/d30a1f45-fdaf-4280-80f2-d5d4fc9743b1

Visão Geral

Este servidor MCP permite que agentes de IA como Claude Desktop, Cursor, Windsurf, etc. realizem consultas WHOIS e obtenham detalhes de domínios.

Propósito Você pode pedir diretamente à IA para verificar se um domínio está disponível, quem o possui, quando foi registrado e outros detalhes importantes. Sem necessidade de abrir o navegador e pesquisar.

O que é uma consulta WHOIS? Uma consulta WHOIS é o processo de consultar um banco de dados WHOIS para obter detalhes de registro sobre um nome de domínio, endereço IP ou sistema autônomo. Ela ajuda os usuários a descobrir quem possui um domínio, quando foi registrado, quando expira e outros detalhes importantes.

Quais informações uma consulta WHOIS pode fornecer?

Ao realizar uma consulta WHOIS, você pode obter detalhes como:

  • Nome do Domínio – O domínio específico consultado
  • Nome do Registrador – A empresa que gerencia o registro do domínio (ex.: GoDaddy, Namecheap)
  • Detalhes do Titular – Nome, organização e dados de contato do proprietário do domínio (a menos que protegidos pela privacidade WHOIS)
  • Data de Registro e Expiração – Quando o domínio foi registrado e quando expirará
  • Servidores de Nomes – Os servidores DNS que o domínio está usando
  • Status do Domínio – Ativo, expirado, bloqueado ou pendente de exclusão
  • Informações de Contato – Contatos administrativo, técnico e de cobrança (se não estiverem ocultos)

Ferramentas Disponíveis

FerramentaDescrição
whois_domainConsulta informações whois sobre o domínio
whois_tldConsulta informações whois sobre o Domínio de Topo (TLD)
whois_ipConsulta informações whois sobre o IP
whois_asConsulta informações whois sobre o Número de Sistema Autônomo (ASN)

Usando com o Cursor

Instalação - Global

Execute o servidor MCP usando npx:

npx -y @bharathvaj/whois-mcp@latest

No seu Cursor IDE

  1. Vá para Cursor Settings > MCP
  2. Clique em + Add New MCP Server
  3. Preencha o formulário:
    • Nome: Whois Lookup (ou qualquer nome que preferir)
    • Tipo: command
    • Comando: npx -y @bharathvaj/whois-mcp@latest

Instalação - Específica do projeto

Adicione um arquivo .cursor/mcp.json ao seu projeto:

{
  "mcpServers": {
    "whois": {
      "command": "npx",
      "args": [
        "-y",
        "@bharathvaj/whois-mcp@latest"
      ]
    }
  }
}

Uso

Uma vez configurado, as ferramentas whois estarão automaticamente disponíveis para o Agente de IA do Cursor. Você pode:

  1. A ferramenta será listada em Available Tools nas configurações do MCP
  2. O agente a usará automaticamente quando relevante
  3. Você pode pedir explicitamente ao agente para enviar notificações

Usando com o Roo Code

Acesse as configurações do MCP clicando em "Edit MCP Settings" nas configurações do Roo Code ou usando o comando "Roo Code: Open MCP Config" na paleta de comandos do VS Code.

{
  "mcpServers": {
    "whois": {
      "command": "npx",
      "args": [
        "-y",
        "@bharathvaj/whois-mcp@latest"
      ]
    }
  }
}
  1. Os recursos whois estarão disponíveis para os agentes de IA do Roo Code

Desenvolvimento

# Install dependencies
pnpm install

# Build
pnpm build

Depurando o servidor

Para depurar seu servidor, você pode usar o MCP Inspector.

Primeiro, compile o servidor

pnpm build

Execute o seguinte comando no seu terminal:

# Start MCP Inspector and server with all tools
npx @modelcontextprotocol/inspector node dist/index.js

Licença

MIT