Untun

Untun MCP - Túneis Seguros para Servidores Locais

❌ Sem Untun MCP

O desenvolvimento local pode ser frustrante quando você precisa expor seu servidor à internet:

• ❌ Configuração complexa de túneis e argumentos de linha de comando
• ❌ Difícil rastrear quais túneis estão em execução em diferentes sessões de terminal
• ❌ Sem uma maneira fácil de gerenciar vários túneis a partir de uma única interface

✅ Com Untun MCP

O Untun MCP cria e gerencia túneis seguros diretamente do seu assistente de IA:

• 1️⃣ Basta dizer ao seu assistente de IA para criar um túnel
• 2️⃣ Obtenha uma URL pública em segundos
• 3️⃣ Gerencie todos os seus túneis com comandos simples em linguagem natural

Sem comandos CLI complexos para memorizar. Sem mais túneis perdidos. Gerenciamento fácil de vários túneis.

⚠️ Aviso

Este projeto usa o pacote untun do npm, mas não é oficialmente afiliado, endossado ou conectado à Cloudflare ou UnJS. Este é um wrapper MCP independente, desenvolvido pela comunidade, em torno da ferramenta CLI untun.

🛠️ Começando

Requisitos

• Node.js >= v18.0.0
• Cliente compatível com MCP (Cursor, Claude Desktop, VS Code, etc.)
• Ferramenta CLI untun (instalada automaticamente conforme necessário)

Instalar no Cursor

Vá para: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Cole a seguinte configuração no seu arquivo ~/.cursor/mcp.json do Cursor:

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

Instalar no VS Code

Instalar no VS Code (npx)

Adicione isto ao seu arquivo de configuração MCP do VS Code:

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

Instalando via Smithery

Para instalar o Untun Secure Tunnel Manager para Claude Desktop automaticamente via Smithery:

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

Instalar no Claude Desktop

Adicione isto ao seu arquivo claude_desktop_config.json do Claude Desktop:

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

🔨 Como Usar

Peça ao seu assistente de IA para criar um túnel com linguagem natural:

Create a tunnel to my localhost:3000 server

Verifique seus túneis em execução:

Show me all my active tunnels

Pare um túnel específico:

Stop the tunnel to localhost:3000

Ferramentas Disponíveis

• start_tunnel: Cria um túnel seguro de um endereço de internet público para o seu servidor local

  • url (obrigatório): A URL local a ser exposta (ex.: http://localhost:3000)
  • name (opcional): Nome personalizado para o túnel

• stop_tunnel: Para um túnel em execução ou todos os túneis locais

  • name (opcional): Nome de um túnel específico a ser parado

• list_tunnels: Lista todos os túneis ativos, incluindo status e detalhes

Solução de Problemas

Túnel Não Iniciando

Se o seu túnel não iniciar, tente estas etapas:

1. Certifique-se de que seu servidor local está em execução
2. Verifique se já existe um túnel em execução para essa porta
3. Use list_tunnels para verificar o status de todos os túneis

Túneis Remotos

Os túneis são rastreados por nome de host. Se você vir túneis "remotos" que não podem ser parados, provavelmente estão em execução em outra máquina. Você precisará pará-los a partir da máquina original.

Desenvolvimento

Clone o projeto e instale as dependências:

npm install

Compile:

npm run build

Licença

MIT