Skuuy MCP Server

Servidor MCP de Ferramentas Skuuy (skuuy-mcp)

Servidor oficial do Model Context Protocol (MCP) para o Ecossistema de Ferramentas Skuuy. Oferece a agentes de IA autônomos (Claude, Gemini, Antigravity, Cursor, Cline) acesso sem fricção a diagnósticos de rede com preservação de privacidade, primitivas de autenticação e utilitários para desenvolvedores.

Recursos e Ferramentas Expostas

Todas as ferramentas são 100% gratuitas, não exigem chaves de API e operam sob uma política rigorosa de zero registro:

1. skuuy_get_egress_ip: Retorna o endereço IP público de saída do chamador com geolocalização, ASN/ISP e detecção de datacenter/proxy. Use para verificar de qual IP e país seu tráfego sai, ou para confirmar se uma VPN/proxy está ativa.
2. skuuy_list_proxies: Lista proxies públicos testados e ativos (HTTP/HTTPS/SOCKS4/SOCKS5) em mais de 150 países, atualizados a cada 30 minutos. Filtre por protocolo, país, nível de anonimato (L1 Elite, L2 Anônimo, L3 Transparente) e latência máxima. Proxies públicos gratuitos são inerentemente não confiáveis — sempre implemente tentativas/fallback.
3. skuuy_generate_totp: Gera uma senha de uso único baseada em tempo (TOTP RFC 6238) a partir de um segredo base32. Privacidade: o segredo é processado efemeramente em memória, nunca registrado ou armazenado. Compatível com segredos do Google Authenticator / Authy / Microsoft Authenticator.
4. skuuy_create_temp_inbox: Cria uma caixa de entrada de e-mail descartável para cadastros e verificações. A caixa de entrada se autodestrói após o TTL (padrão de 30 minutos).
5. skuuy_read_inbox: Lê mensagens em uma caixa de entrada temporária criada por skuuy_create_temp_inbox. Cada mensagem inclui corpo em texto simples e códigos OTP de 4 a 8 dígitos extraídos automaticamente e links de ação (ex.: URLs de redefinição de senha) quando detectados.
6. skuuy_resolve_dns: Resolve registros DNS (A, AAAA, CNAME, MX, TXT, NS, SOA) para um domínio via Cloudflare Anycast DoH com validação DNSSEC. Matriz opcional de propagação global entre PoPs de borda.
7. skuuy_check_ports: Verifica se portas de serviço comuns estão abertas (conexão TCP) em um host. Proteção contra abuso: apenas uma lista fixa de permissões pode ser testada (22 SSH, 80 HTTP, 443 HTTPS, 3306 MySQL, 5432 Postgres, 6379 Redis, 51820 WireGuard). Destinado a diagnosticar suas próprias implantações — não para escanear terceiros.
8. skuuy_check_security_headers: Audita a postura de segurança de uma URL: cabeçalhos de segurança (HSTS, CSP, X-Frame-Options, Permissions-Policy, etc.), cadeia completa de redirecionamentos e saúde do certificado TLS (emissor, expiração, dias restantes).
9. skuuy_read_url: Busca qualquer URL pública e retorna markdown limpo (anúncios, banners de cookies, elementos de navegação e tags de script removidos; páginas renderizadas com JavaScript renderizadas da melhor forma possível). Escopo honesto: desafios anti-bot difíceis (CAPTCHA interativo) não são contornados.
10. skuuy_create_webhook_bin: Cria uma URL efêmera de captura de webhook (bin.skuuy.com/w/<id>) que registra requisições HTTP recebidas com cabeçalhos e corpo completos. Aponte um callback de terceiros (Stripe, GitHub, sua própria API) para ela durante a depuração e depois inspecione com skuuy_get_bin_requests. Excluída automaticamente após o TTL.
11. skuuy_get_bin_requests: Lista requisições HTTP capturadas por um bin de webhook criado com skuuy_create_webhook_bin: método, cabeçalhos, parâmetros de consulta e corpo (truncado em 1 MB).
12. skuuy_hash_encode: Utilitários de hash/codificação de uso único: SHA-256, SHA-512, codificação/decodificação Base64, UUID v4 e geração de senha criptograficamente aleatória. (MD5 incluído apenas para verificação de checksum legado — não use para segurança.)
13. skuuy_search_public_apis: Pesquisa mais de 1.400 APIs públicas para desenvolvedores com filtros de autenticação, CORS e status de saúde.
14. skuuy_drop_file: Compartilhe um arquivo com o usuário ou qualquer outra pessoa: envie o conteúdo do arquivo como base64 (ou uma URL pública para o servidor buscar) e receba um link público de download de curta duração. Zero registro, exclusão automática após o TTL (máx. 7 dias), opção de apagar após leitura. Plano gratuito: 25 envios/dia, máx. 10 MB por arquivo.
15. skuuy_paste: Compartilhe um trecho de texto/markdown como uma página pública de curta duração. Mesmo modelo de TTL com zero registro dos envios de arquivo. Plano gratuito: 25 colagens/dia.
16. skuuy_rpc: Envia uma chamada JSON-RPC somente leitura via Relé RPC Privado Skuuy (rpc.skuuy.com/<chain>): 12 cadeias EVM, zero registro, sem chave de API. Plano gratuito: 2.500 chamadas/dia/IP no relé.

Nota sobre endpoints REST pagos: skuuy_drop_file, skuuy_paste, skuuy_rpc e o REST read_url são gratuitos até uma cota diária em seus endpoints REST (file.skuuy.com, rpc.skuuy.com, read.skuuy.com), depois pagos por requisição via x402 na Base ($0,001/chamada para relé RPC, $0,005 para arquivo/leitura). As próprias ferramentas MCP são sempre gratuitas e com limite de taxa — clientes MCP não são compatíveis com x402, então as ferramentas nunca têm paywall.

---

Instalação e Configuração

1. Claude Desktop

Adicione ao seu claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json no Windows, ou ~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

{
  "mcpServers": {
    "skuuy": {
      "command": "npx",
      "args": ["-y", "skuuy-mcp"]
    }
  }
}

2. IDE Cursor

Adicione ao .cursor/mcp.json ou em Configurações do Cursor -> Recursos -> MCP:

{
  "mcpServers": {
    "skuuy": {
      "command": "npx",
      "args": ["-y", "skuuy-mcp"]
    }
  }
}

3. Antigravity / Google Agents

Adicione à configuração MCP do seu agente:

{
  "mcpServers": {
    "skuuy": {
      "command": "node",
      "args": ["D:/Skuuy/skuuy-mcp/dist/index.js"]
    }
  }
}

---

Desenvolvimento Local

git clone https://github.com/deaabie/skuuy-mcp.git
cd skuuy-mcp
npm install
npm run build
npm start

Privacidade e Segurança

• Conhecimento Zero: segredos de 2FA e hashes são processados em memória e nunca registrados em discos ou bancos de dados de telemetria.
• TTL Estrito: e-mails temporários, bins de webhook e arquivos compartilhados expiram automaticamente.
• Seguro contra SSRF: verificação de portas e leitura web restringem sub-redes privadas RFC 1918 e endereços de loopback.
• Proteções contra Abuso: verificações de porta são somente com lista de permissões; envios de arquivo são limitados por cota por IPv6 /64.

Licença

MIT © Ferramentas Skuuy