MCP Tunnel

一个简单的 MCP (模型上下文协议) 服务器，允许访问虚拟机 (VM) 的命令行。启动后，它还会将主机隧道连接到 Web，以便可以通过 MCP 访问。

特性

• 通过 MCP 在 VM 上执行 shell 命令
• 用于 VM 交互的基于 Web 的终端界面
• 自动隧道连接，使 VM 可以从任何地方访问
• 基于 WebSocket 的实时通信

前提条件

• 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

使用

1. 启动 MCP 服务器：

# 启动并自动隧道连接
npm start

# 启动但不自动隧道连接
npm start -- --no-tunnel

这将构建项目并启动服务器。默认情况下，将自动创建一个隧道。使用 --no-tunnel 标志禁用自动隧道连接。

2. 服务器将启动并在 stderr 上提供输出（以避免干扰 stdout 上的 MCP 通信）

3. 使用 MCP 通过以下工具与服务器交互：

可用的 MCP 工具

• execute_command: 在 VM 上运行 shell 命令
  • 参数: { "command": "你的 shell 命令" }
• start_tunnel: 创建一个 Web 隧道以访问 VM 界面
  • 参数: { "port": 8080, "subdomain": "可选子域名" }

Web 界面

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

• 直接在 VM 中执行命令
• 实时查看命令输出
• 从任何具有 Web 访问权限的设备与 VM 交互

环境变量

创建一个 .env 文件来配置服务器：

# 服务器配置
PORT=8080

# Localtunnel 配置
LOCALTUNNEL_SUBDOMAIN=你偏好的子域名

安全注意事项

此工具提供对 VM 命令行的直接访问。请考虑以下安全措施：

• 在暴露隧道之前使用强大的身份验证机制
• 通过适当的验证限制可以执行的命令
• 考虑在受限环境中运行
• 不要通过隧道暴露敏感信息