cliptunnel-mcp Skill 技能

技能简介

cliptunnel-mcp 是一款将剪贴板转化为可靠控制通道的远程操作工具，专为 AI Agent 设计。当远程机器处于 Citrix 会话、锁屏 VDI 或其他严格限制 SSH/文件传输/网络的隔离环境中，只要剪贴板可用，cliptunnel-mcp 就能将命令通过剪贴板隧道传输，并以 MCP（Model Context Protocol）工具的形式暴露给 Claude、Cursor、Pi 等主流 AI 编程 Agent。v1.2.0 支持 4 种传输层（剪贴板/HTTPS 中继/WebSocket 中继/Firebase），可选 AES-256-GCM 加密，27 个 MCP 工具，覆盖远程 Shell、文件操作、二进制传输、系统信息、Copilot Agent 管理等完整操作栈。

核心能力

• 4 种传输层：剪贴板（默认）、HTTPS 中继、WebSocket 中继、Firebase 实时数据库
• CT3 协议：专用有线协议，支持前缀端点 ID、广播路由、心跳自愈、宣布发现机制
• AES-256-GCM 加密：可选协议层加密，兼容任何传输层
• 27 个 MCP 工具：覆盖远程 Shell、文件系统、二进制传输、系统信息、Copilot Agent 生命周期管理
• 心跳自愈：Agent 每 120 秒重新广播注册信息，网络中断恢复后自动重连
• 剪贴板恢复：每次命令交换后自动恢复用户原始剪贴板内容
• 多远程支持：Controller 可同时管理多台远程机器
• Zombie 任务检测：检测命令响应丢失的超时任务

安装配置

pip install cliptunnel-mcp
pip install "cliptunnel-mcp[server]"

使用步骤

1. 在远程机器上启动 Agent

   cliptunnel-agent

2. 在操作机器上配置 MCP Client

   {
     "mcpServers": {
       "cliptunnel": {
         "command": "cliptunnel-mcp",
         "args": []
       }
     }
   }

3. 使用 MCP 工具操作远程机器

   remote_shell remote_id="R1b2c3d4" cmd="whoami"
   remote_fs_read remote_id="R1b2c3d4" path="/etc/hostname"
   remote_upload remote_id="R1b2c3d4" local_path="./config.yaml" remote_path="/tmp/config.yaml"
   remote_sysinfo remote_id="R1b2c3d4"
   remote_agent_start remote_id="R1b2c3d4"

适用场景

• 锁屏 VDI / Citrix 环境：无法 SSH、无法 SFTP，但剪贴板可用的企业办公环境
• 隔离开发机：公司配发的锁屏 Windows 机器，需要 AI Agent 帮忙操作
• 远程服务器无 SSH 入口：仅有 Web 界面或剪贴板可用的情况
• 多机器并行操作：同时对多台远程机器执行相同的配置或检查操作
• AI 远程调试：通过 Agent 操控远程开发机，无需切换到远程桌面

适用人群

• 在 Citrix/VDI 环境下工作的企业开发者
• 需要操控隔离远程机器的运维/DevOps 工程师
• 使用 AI 编程 Agent 进行远程开发协作的程序员

工作原理

cliptunnel-mcp 由 Controller（操作端）和 Agent（远程端）组成。Agent 在远程机器上运行，监听剪贴板变化或网络传输通道；Controller 在操作机器上运行，通过 MCP Server 将操作暴露给 AI Agent。CT3 协议将命令和响应封装为统一格式，通过选定的传输层交换。每次交换结束后，Controller 自动恢复用户原始剪贴板内容。

官方链接

• PyPI：https://pypi.org/project/cliptunnel-mcp/
• GitHub：https://github.com/jordi-murgo/cliptunnel-mcp