Don Dominio

Servidor MCP não oficial que expõe a API de revenda DonDominio / MrDomain como ferramentas acionáveis por LLM

Documentação

Servidor MCP DonDominio

Um servidor MCP não oficial que expõe toda a API de revenda DonDominio / MrDomain como 106 ferramentas chamáveis por LLM. Gerencie domínios, hospedagem, certificados SSL e usuários externos a partir do Claude, Cursor, Cline, Codex, Hermes ou qualquer cliente compatível com MCP.

Não afiliado à DonDominio / MrDomain. Use por sua conta e risco e respeite a política de uso.

Início rápido

git clone https://github.com/ec-dev0/don-dominio-mcp
cd don-dominio-mcp
npm install && npm run build
cp .env.example .env        # set DONDOMINIO_API_USER / DONDOMINIO_API_PASS
node dist/index.js          # stdio mode

Instalação pelo GitHub (npx)

Aponte qualquer cliente MCP para o repositório; o npx clona, compila e executa para você:

{
  "mcpServers": {
    "don-dominio": {
      "command": "npx",
      "args": ["-y", "github:ec-dev0/don-dominio-mcp"],
      "env": {
        "DONDOMINIO_API_USER": "your_api_user",
        "DONDOMINIO_API_PASS": "your_api_password"
      }
    }
  }
}

Quando iniciado por um cliente via npx, os arquivos .env não são lidos — forneça as credenciais apenas pelo bloco env da configuração.

Requisitos

Node.js ≥ 20.
Uma conta DonDominio / MrDomain com acesso à API habilitado (solicite aqui).
O IP público do chamador deve estar na lista de permissões no painel da DonDominio. Verifique o IP que a DonDominio vê com dondominio_tool_hello ou dondominio_account_info.

Configuração

Variável	Padrão	Descrição
`DONDOMINIO_API_USER`	(obrigatório)	Nome de usuário da API DonDominio.
`DONDOMINIO_API_PASS`	(obrigatório)	Senha da API DonDominio.
`TRANSPORT`	`stdio`	`stdio` ou `http`.
`PORT`	`3000`	Porta HTTP (apenas com `TRANSPORT=http`).
`ALLOWED_HOSTS`	`localhost,127.0.0.1,[::1]`	Hosts permitidos (proteção contra DNS-rebinding).
`ALLOWED_ORIGINS`	`localhost,127.0.0.1`	Cabeçalhos `Origin` permitidos.
`MCP_AUTH_TOKEN`	(não definida)	Se definida, `/mcp` exige `Authorization: Bearer <token>`.
`MCP_MAX_CONCURRENT`	`3`	Máximo de requisições simultâneas por IP (→ 429). Corresponde à política de uso da DonDominio (3 conexões por IP).
`DEBUG`	`1` para habilitar	Saída de diagnóstico em `stderr`.

Uso

# stdio (default) – for local agents
DONDOMINIO_API_USER=... DONDOMINIO_API_PASS=... node dist/index.js

# HTTP – for remote agents (http://localhost:3000/mcp)
TRANSPORT=http PORT=3000 DONDOMINIO_API_USER=... DONDOMINIO_API_PASS=... node dist/index.js

Inspector (depurador interativo)

npm run inspect   # npx @modelcontextprotocol/inspector dist/index.js

Abre uma interface web para explorar todas as 106 ferramentas, seus esquemas e testá-las sem riscos.

Ferramentas disponíveis

Módulo	Ferramentas	O que permite fazer
`tool/`	6	Hello, IDN/Punycode, sugestão de domínio, tabelas ISO, DIG, zone-check.
`account/`	3	Informações e saldo, promoções, catálogo de TLDs com preços.
`domain/`	24	Consulta, registro, transferência, renovação, NS, contatos, DNSSEC…
`contact/`	4	Modelos reutilizáveis de contato WHOIS.
`service/`	47	Hospedagem: FTP, bancos de dados, subdomínios, redirecionamentos, e-mail, DNS.
`ssl/`	13	CSR, produtos, ciclo de vida do certificado, validação, SAN.
`user/`	9	Usuários externos do painel e permissões por domínio.

Exemplos

"O example.es está disponível?" → dondominio_domain_check
"Converta año.es para Punycode." → dondominio_tool_idn_converter
"Liste meus domínios .com." → dondominio_domain_list
"Crie a caixa de e-mail info@mydomain.com no serviço srv-mydomain." → dondominio_service_mail_create

Não faça loop em dondominio_domain_check ou dondominio_tool_domain_suggests; a DonDominio bane contas por verificações massivas de disponibilidade.

Segurança

Todas as chamadas são feitas via HTTPS para https://simple-api.dondominio.net/.
Transporte HTTP reforçado: validação de Host/Origin, autenticação Bearer opcional e limite de concorrência por IP.
As ferramentas declaram anotações honestas para o LLM (readOnlyHint, destructiveHint, idempotentHint, openWorldHint).

Solução de problemas

Sintoma	Causa / correção
Erro `100` ao chamar uma ferramenta	Credenciais inválidas ou IP não autorizado.
Erro `12`	Seu IP não está na lista de permissões da DonDominio.
O cliente desconecta na inicialização	Sem registros em `stdout` por padrão; use `DEBUG=1` para diagnósticos em stderr.
HTTP 401	`Authorization: Bearer <MCP_AUTH_TOKEN>` ausente.
HTTP 429	Muitas requisições simultâneas de um mesmo IP; aguarde ou aumente `MCP_MAX_CONCURRENT`.

Desenvolvimento

npm install
npm run dev         # tsx watch (hot reload)
npm run build       # tsc → dist/
npm run inspect     # MCP Inspector
npm run clean       # rm -rf dist

A estrutura do código e as convenções estão em AGENTS.md.

Licença

MIT — veja LICENSE.