MCP Tunnel

基本能力

产品定位

MCP Tunnel 是一个用于通过 MCP 协议访问虚拟机命令行的工具，提供 Web 终端界面和自动隧道功能。

核心功能

• 通过 MCP 在虚拟机上执行 shell 命令
• 提供基于 Web 的终端界面，用于与虚拟机交互
• 自动隧道功能，使虚拟机可以从任何地方访问
• 基于 WebSocket 的实时通信

适用场景

• 远程管理和操作虚拟机
• 开发调试环境中的命令行访问
• 需要从任何设备访问虚拟机的场景

工具列表

• execute_command: 在虚拟机上运行 shell 命令
• 参数: { "command": "your shell command" }
• start_tunnel: 创建 Web 隧道以访问虚拟机界面
• 参数: { "port": 8080, "subdomain": "optional-subdomain" }

常见问题解答

• 安全性问题: 该工具直接提供对虚拟机命令行的访问，建议使用强认证机制，限制可执行的命令，并在受限环境中运行。
• 隧道配置: 可以通过 .env 文件配置服务器和隧道参数。

使用教程

使用依赖

• Node.js (v18 或更新版本)

安装教程

使用 npx 运行（无需安装）

npx mcp-cli

全局安装

npm install -g mcp-cli
mcp-cli

本地开发

# 克隆仓库
git clone [repository-url]
cd mcp-cli

# 安装依赖
npm install

调试方式

启动开发服务器（支持热重载）

npm run dev

构建生产版本

npm run build-all

启动 MCP 服务器

# 启动并自动创建隧道
npm start

# 启动但不自动创建隧道
npm start -- --no-tunnel

访问 Web 界面

启动隧道后，可以通过隧道提供的 URL 访问基于 Web 的终端界面。

许可证

None