Untun

Untun MCP - Túneles seguros para servidores locales

❌ Sin Untun MCP

El desarrollo local puede ser frustrante cuando necesitas exponer tu servidor a internet:

• ❌ Configuración compleja de túneles y argumentos de línea de comandos
• ❌ Difícil de rastrear qué túneles están en ejecución en diferentes sesiones de terminal
• ❌ No hay una forma fácil de gestionar múltiples túneles desde una única interfaz

✅ Con Untun MCP

Untun MCP crea y gestiona túneles seguros directamente desde tu asistente de IA:

• 1️⃣ Simplemente dile a tu asistente de IA que cree un túnel
• 2️⃣ Obtén una URL pública en segundos
• 3️⃣ Gestiona todos tus túneles con simples comandos en lenguaje natural

No hay comandos CLI complejos que recordar. No más túneles perdidos. Gestión fácil de múltiples túneles.

⚠️ Aviso legal

Este proyecto utiliza el paquete untun de npm pero no está afiliado oficialmente, respaldado o conectado con Cloudflare o UnJS. Este es un envoltorio MCP independiente, desarrollado por la comunidad, alrededor de la herramienta CLI untun.

🛠️ Primeros pasos

Requisitos

• Node.js >= v18.0.0
• Cliente compatible con MCP (Cursor, Claude Desktop, VS Code, etc.)
• untun herramienta CLI (instalada automáticamente según sea necesario)

Instalación en Cursor

Ve a: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Pega la siguiente configuración en tu archivo ~/.cursor/mcp.json de Cursor:

{
  "mcpServers": {
    "untun": {
      "command": "npx",
      "args": ["-y", "@minte-app/untun-mcp@latest"]
    }
  }
}

Instalación en VS Code

Install in VS Code (npx)

Añade esto a tu archivo de configuración MCP de VS Code:

{
  "servers": {
    "Untun": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@minte-app/untun-mcp@latest"]
    }
  }
}

Instalación mediante Smithery

Para instalar Untun Secure Tunnel Manager para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @minte-app/untun-mcp --client claude

Instalación en Claude Desktop

Añade esto a tu archivo claude_desktop_config.json de Claude Desktop:

{
  "mcpServers": {
    "Untun": {
      "command": "npx",
      "args": ["-y", "@minte-app/untun-mcp@latest"]
    }
  }
}

🔨 Cómo usar

Pide a tu asistente de IA que cree un túnel con lenguaje natural:

Create a tunnel to my localhost:3000 server

Comprueba tus túneles en ejecución:

Show me all my active tunnels

Detén un túnel específico:

Stop the tunnel to localhost:3000

Herramientas disponibles

• start_tunnel: Crea un túnel seguro desde una dirección de internet pública a tu servidor local

  • url (obligatorio): La URL local a exponer (por ejemplo, http://localhost:3000)
  • name (opcional): Nombre personalizado para el túnel

• stop_tunnel: Detiene un túnel en ejecución o todos los túneles locales

  • name (opcional): Nombre de un túnel específico a detener

• list_tunnels: Lista todos los túneles activos incluyendo su estado y detalles

Solución de problemas

El túnel no se inicia

Si tu túnel no se inicia, prueba estos pasos:

1. Asegúrate de que tu servidor local esté en ejecución
2. Comprueba si ya hay un túnel en ejecución para ese puerto
3. Usa list_tunnels para comprobar el estado de todos los túneles

Túneles remotos

Los túneles se rastrean por nombre de host. Si ves túneles "remotos" que no se pueden detener, es probable que se estén ejecutando en otra máquina. Deberás detenerlos desde la máquina original.

Desarrollo

Clona el proyecto e instala las dependencias:

npm install

Compilar:

npm run build

Licencia

MIT