Skuuy MCP Server

Servidor MCP de Herramientas Skuuy (skuuy-mcp)

Servidor oficial del Protocolo de Contexto de Modelos (MCP) para el Ecosistema de Herramientas Skuuy. Brinda a agentes de IA autónomos (Claude, Gemini, Antigravity, Cursor, Cline) acceso sin fricción a diagnósticos de red que preservan la privacidad, primitivas de autenticación y utilidades para desarrolladores.

Características y Herramientas Expuestas

Todas las herramientas son 100% gratuitas, no requieren claves API y operan bajo una estricta política de cero registros:

1. skuuy_get_egress_ip: Devuelve la dirección IP pública de salida del llamante con geolocalización, ASN/ISP y detección de centro de datos/proxy. Úsalo para verificar desde qué IP y país sale tu tráfico, o para confirmar que una VPN/proxy está activa.
2. skuuy_list_proxies: Lista proxies públicos probados y en vivo (HTTP/HTTPS/SOCKS4/SOCKS5) en más de 150 países, actualizados cada 30 minutos. Filtra por protocolo, país, nivel de anonimato (L1 Élite, L2 Anónimo, L3 Transparente) y latencia máxima. Los proxies públicos gratuitos son inherentemente poco confiables: siempre implementa reintentos/respaldos.
3. skuuy_generate_totp: Genera una contraseña de un solo uso basada en tiempo (TOTP RFC 6238) a partir de un secreto base32. Privacidad: el secreto se procesa efímeramente en memoria, nunca se registra ni almacena. Compatible con secretos de Google Authenticator / Authy / Microsoft Authenticator.
4. skuuy_create_temp_inbox: Crea una bandeja de entrada de correo desechable para registros y verificaciones. La bandeja se autodestruye después del TTL (30 minutos por defecto).
5. skuuy_read_inbox: Lee mensajes en una bandeja temporal creada por skuuy_create_temp_inbox. Cada mensaje incluye el cuerpo en texto plano y códigos OTP de 4–8 dígitos extraídos automáticamente y enlaces de acción (por ejemplo, URL de restablecimiento de contraseña) cuando se detectan.
6. skuuy_resolve_dns: Resuelve registros DNS (A, AAAA, CNAME, MX, TXT, NS, SOA) para un dominio mediante Cloudflare Anycast DoH con validación DNSSEC. Matriz de propagación global opcional entre PoPs de borde.
7. skuuy_check_ports: Verifica si los puertos de servicios comunes están abiertos (conexión TCP) en un host. Protección contra abuso: solo se puede probar una lista fija permitida (22 SSH, 80 HTTP, 443 HTTPS, 3306 MySQL, 5432 Postgres, 6379 Redis, 51820 WireGuard). Diseñado para diagnosticar tus propias implementaciones, no para escanear terceros.
8. skuuy_check_security_headers: Audita la postura de seguridad de una URL: encabezados de seguridad (HSTS, CSP, X-Frame-Options, Permissions-Policy, etc.), cadena completa de redirecciones y salud del certificado TLS (emisor, expiración, días restantes).
9. skuuy_read_url: Obtiene cualquier URL pública y devuelve markdown limpio (anuncios, banners de cookies, navegación y etiquetas de script eliminados; páginas renderizadas con JS se procesan con el mejor esfuerzo). Alcance honesto: los desafíos anti-bot difíciles (CAPTCHA interactivo) no se evaden.
10. skuuy_create_webhook_bin: Crea una URL efímera de captura de webhooks (bin.skuuy.com/w/<id>) que registra solicitudes HTTP entrantes con encabezados y cuerpo completos. Apunta una devolución de llamada de terceros (Stripe, GitHub, tu propia API) mientras depuras, luego inspecciona con skuuy_get_bin_requests. Se elimina automáticamente después del TTL.
11. skuuy_get_bin_requests: Lista las solicitudes HTTP capturadas por un contenedor de webhooks creado con skuuy_create_webhook_bin: método, encabezados, parámetros de consulta y cuerpo (truncado a 1 MB).
12. skuuy_hash_encode: Utilidades de hash/codificación de un solo uso: SHA-256, SHA-512, codificación/decodificación Base64, UUID v4 y generación de contraseñas criptográficamente aleatorias. (MD5 incluido solo para verificación de sumas de verificación heredadas; no lo uses para seguridad).
13. skuuy_search_public_apis: Busca más de 1,400 API de desarrolladores públicas con filtros de autenticación, CORS y estado de salud.
14. skuuy_drop_file: Comparte un archivo con el usuario o cualquier otra persona: pasa el contenido del archivo como base64 (o una URL pública para que el servidor lo obtenga) y recibe un enlace de descarga público de corta duración. Cero registros, se elimina automáticamente después del TTL (máximo 7 días), opción de autodestrucción al leer. Nivel gratuito: 25 envíos/día, máximo 10 MB por archivo.
15. skuuy_paste: Comparte un fragmento de texto/markdown como página pública de corta duración. Mismo modelo de TTL de cero registros que los envíos de archivos. Nivel gratuito: 25 publicaciones/día.
16. skuuy_rpc: Envía una llamada JSON-RPC de solo lectura a través del Relé RPC Privado Skuuy (rpc.skuuy.com/<chain>): 12 cadenas EVM, cero registros, sin clave API. Nivel gratuito: 2,500 llamadas/día/IP en el relé.

Nota sobre endpoints REST de pago: skuuy_drop_file, skuuy_paste, skuuy_rpc y el REST read_url son gratuitos hasta una cuota diaria en sus endpoints REST (file.skuuy.com, rpc.skuuy.com, read.skuuy.com), luego se pagan por solicitud vía x402 en Base ($0.001/llamada para el relé RPC, $0.005 para archivo/lectura). Las herramientas MCP en sí siempre son gratuitas y con límite de velocidad: los clientes MCP no son compatibles con x402, por lo que las herramientas nunca tienen muro de pago.

---

Instalación y Configuración

1. Claude Desktop

Agrega a tu claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json en Windows, o ~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

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

2. IDE Cursor

Agrega a .cursor/mcp.json o Configuración de Cursor -> Funciones -> MCP:

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

3. Antigravity / Agentes de Google

Agrega a la configuración MCP de tu agente:

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

---

Desarrollo Local

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

Privacidad y Seguridad

• Conocimiento Cero: los secretos 2FA y los hashes se procesan en memoria y nunca se registran en discos o bases de datos de telemetría.
• TTL Estricto: los correos temporales, contenedores de webhooks y archivos compartidos expiran automáticamente.
• Seguro contra SSRF: el escaneo de puertos y la lectura web restringen las subredes privadas RFC 1918 y las direcciones de loopback.
• Protecciones contra Abuso: las verificaciones de puertos son solo de lista permitida; los envíos de archivos tienen cuotas por IPv6 /64.

Licencia

MIT © Herramientas Skuuy