MCP Tunnel

🚀 MCP 隧道服務器

MCP 隧道服務器是一個簡單的 MCP（模型上下文協議）服務器，它允許通過 MCP 訪問 VM 機器的命令行界面。在啟動時，該服務器還會自動創建隧道，讓 VM 能夠從 Web 進行訪問，為用戶提供便捷的操作體驗。

✨ 主要特性

• 命令執行：可在 VM 上執行 shell 命令。
• Web 交互：藉助基於 Web 的終端界面與 VM 進行交互。
• 自動隧道：具備自動隧道功能，使 VM 能從任意位置被訪問。
• 即時通信：採用 WebSocket 實現即時通信。

📦 安裝指南

先決條件

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

安裝方式

使用 npx（無需安裝）

npx mcp-cli

全局安裝

npm install -g mcp-cli
mcp-cli

本地開發

# 克隆倉庫
git clone [倉庫地址]
cd mcp-cli

# 安裝依賴項
npm install

💻 使用示例

開發

運行帶有熱重載的開發服務器，同時為前後端進行更新：

npm run dev

構建

構建生產環境下的前端和後端：

npm run build-all

使用步驟

1. 啟動 MCP 服務器：

# 帶自動隧道功能啟動
npm start

# 不帶自動隧道功能啟動
npm start -- --no-tunnel

這將構建項目並啟動服務器。默認情況下會創建一個隧道。使用 --no-tunnel 標誌可禁用自動隧道。

2. 服務器啟動後會在 stderr 提供輸出（以避免干擾 MCP 通信的 stdout）

3. 使用 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 文件以配置服務器：

# 服務器配置
PORT=8080

# Localtunnel 配置
LOCALTUNNEL_SUBDOMAIN=your-preferred-subdomain

安全注意事項

此工具提供對 VM 命令行的直接訪問。考慮以下安全實踐：

• 在暴露隧道之前使用強身份驗證機制
• 通過適當的身份驗證限制可以執行的命令
• 考慮在受限環境中運行
• 不要通過隧道洩露敏感信息