安全隧道管理工具

Untun MCP是一款用于创建和管理本地服务器安全隧道的工具,通过AI助手简化隧道设置和管理流程,适用于开发测试和远程访问场景。

  • by minte-app
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 minte-app/untun-mcp

使用说明

Untun MCP-本地服务器的安全隧道

❌ 无Untun MCP

当您需要将服务器暴露在互联网上时,本地开发可能会令人沮丧:

  • ❌ 复杂的隧道设置和命令行参数
  • ❌ 很难追踪哪些隧道在不同的终端会话中运行
  • ❌ 没有简单的方法从单个界面管理多个隧道

✅ 使用Untun MCP

Untun MCP直接从您的AI助手创建和管理安全隧道:

  • 1.️⃣ 只需告诉你的AI助手创建一个隧道
  • 2.️⃣ 在几秒钟内获取公共URL
  • 3.️⃣ 使用简单的自然语言命令管理所有隧道

无需记住复杂的CLI命令。不再有丢失的隧道。轻松管理多条隧道。

⚠️ 免责声明

该项目使用 为 来自npm的包,但 不 与Cloudflare或UnJS正式关联、认可或连接。这是一个独立的、社区开发的围绕untun CLI工具的MCP包装器。

🛠️ 入门指南

需求

  • Node.js>=v18.0.0
  • MCP兼容客户端(光标、克劳德桌面、VS代码等)
  • untun CLI工具(根据需要自动安装)

在游标中安装

首选 Settings -> Cursor Settings -> MCP -> Add new global MCP server

将以下配置粘贴到游标中 ~/.cursor/mcp.json 文件:

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

在VS代码中安装

在VS代码(npx)中安装

将此添加到您的VS Code MCP配置文件中:

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

通过Smithery安装

通过以下方式自动安装适用于Claude Desktop的Untun安全隧道管理器 史密瑟里:

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

在Claude桌面中安装

将此添加到您的Claude桌面 claude_desktop_config.json 文件:

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

🔨 如何使用

让你的AI助手用自然语言创建一个隧道:

Create a tunnel to my localhost:3000 server

检查你的跑步隧道:

Show me all my active tunnels

停止特定隧道:

Stop the tunnel to localhost:3000

可用工具

  • start_tunnel:创建从公共internet地址到本地服务器的安全隧道

    • url (必填):要公开的本地URL(例如。,http://localhost:3000)
    • name (可选):隧道的自定义名称
  • stop_tunnel:停止正在运行的隧道或所有本地隧道

    • name (可选):要停止的特定隧道的名称
  • list_tunnels:列出所有活动隧道,包括其状态和详细信息

故障排除

隧道未启动

如果你的隧道没有启动,请尝试以下步骤:

  1. 确保您的本地服务器正在运行
  2. 检查该端口是否已经有隧道在运行
  3. 使用 list_tunnels 检查所有隧道的状态

远程隧道

隧道按主机名跟踪。如果你看到无法停止的“远程”隧道,它们很可能在另一台机器上运行。你需要从原始机器上阻止它们。

发展

克隆项目并安装依赖项:

npm install

构建:

npm run build

许可证

麻省理工学院