mcpField
M
MCP Tunnel

MCP Tunnel

本地服务
github.com/leomercier开发工具584 周前更新
代码仓库

关于 MCP Tunnel

MCP 服务，用于在虚拟机上执行 Shell 命令，并提供浏览器终端和可选的自动 Web 隧道，适合需要访问虚拟机命令行的 MCP 客户端。

主要功能

  1. 01通过 MCP 执行虚拟机 Shell 命令
  2. 02基于浏览器的终端
  3. 03自动创建 Web 隧道
  4. 04基于 WebSocket 的实时通信

适用场景

  1. 01从 MCP 客户端在虚拟机上运行命令
  2. 02通过 Web 地址打开虚拟机终端

MCP 相关

提供 `execute_command` 工具执行 Shell 命令，并提供 `start_tunnel` 工具创建 Web 隧道。MCP 客户端可通过这些工具访问虚拟机及其 Web 终端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "tunnel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-cli"
      ]
    }
  }
}
启动命令npx -y mcp-cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmmcp-cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MCP Tunnel

一个简单的 MCP（Model Context Protocol）服务，可用于访问 VM 的命令行。启动后，它还会将主机通过隧道连接到 Web，以便通过 MCP 访问。

功能

  • 通过 MCP 在 VM 上执行 shell 命令
  • 用于与 VM 交互的 Web 终端界面
  • 自动创建隧道，让你可以从任何位置访问 VM
  • 基于 WebSocket 的实时通信

前提条件

  • Node.js（v18 或更高版本）

安装和使用

使用 npx 运行（无需安装）
npx mcp-cli
全局安装
npm install -g mcp-cli
mcp-cli
本地开发
# Clone repository
git clone [repository-url]
cd mcp-cli

# Install dependencies
npm install

开发

运行开发服务器，对后端和前端进行热重载：

npm run dev

构建

构建用于生产环境的前端和后端：

npm run build-all

使用

  1. 启动 MCP 服务：
# Start with automatic tunneling
npm start

# Start without automatic tunneling
npm start -- --no-tunnel

这将构建项目并启动服务。默认情况下会自动创建隧道。使用 --no-tunnel 标志可禁用自动创建隧道。

  1. 服务将启动，并在 stderr 上输出信息（以避免干扰 stdout 上的 MCP 通信）

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

可用的 MCP 工具
  • execute_command：在 VM 上运行 shell 命令
    • 参数：{ "command": "your shell command" }
  • start_tunnel：创建 Web 隧道以访问 VM 界面
    • 参数：{ "port": 8080, "subdomain": "optional-subdomain" }

Web 界面

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

  • 直接在 VM 中执行命令
  • 实时查看命令输出
  • 通过任何可访问 Web 的设备与 VM 交互

环境变量

创建 .env 文件以配置服务：

# Server configuration
PORT=8080

# Localtunnel configuration
LOCALTUNNEL_SUBDOMAIN=your-preferred-subdomain

安全注意事项

此工具可直接访问 VM 的命令行。请考虑采取以下安全措施：

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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。