💻 mcp-vnc

一个 Model Context Protocol (MCP) 服务器，使 AI 代理能够远程控制 Windows、Linux、macOS 或任何其他可以运行 VNC 服务器的东西（别担心，应该没问题）。

🚀 快速开始

从 NPM 安装

npm install -g @hrrrsn/mcp-vnc

从源码安装

git clone https://github.com/hrrrsn/mcp-vnc
cd mcp-vnc
npm install
npm run build

Related MCP server: mcp-vnc

⚙️ 配置

Claude Desktop

1. 找到并打开你的 Claude Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows：%APPDATA%\Claude\claude_desktop_config.json

   • Linux：~/.config/Claude/claude_desktop_config.json

2. 添加以下配置：

使用 NPM 安装：

{
  "mcpServers": {
    "vnc-controller": {
      "type": "stdio",
      "command": "mcp-vnc",
      "env": {
        "VNC_HOST": "192.168.1.100",
        "VNC_PORT": "5900",
        "VNC_PASSWORD": "your-vnc-password",
        "VNC_TIMEOUT": "30000"
      }
    }
  }
}

从源码构建：

{
  "mcpServers": {
    "vnc-controller": {
      "type": "stdio",
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/mcp-vnc",
      "env": {
        "VNC_HOST": "192.168.1.100",
        "VNC_PORT": "5900",
        "VNC_PASSWORD": "your-vnc-password",
        "VNC_TIMEOUT": "30000"
      }
    }
  }
}

VNC_TIMEOUT（可选）设置每次工具调用等待 VNC 服务器连接并交付初始帧的时间，单位为毫秒。默认为 30000。

VS Code

请参阅 VS Code 文档

HTTP 传输（Streamable HTTP）

默认情况下，服务器使用 stdio。要改为通过 HTTP 暴露它：

# Via environment variables
VNC_HOST=192.168.1.100 VNC_PORT=5900 VNC_PASSWORD=secret \
MCP_TRANSPORT=http MCP_PORT=3000 mcp-vnc

# Or via CLI arguments
mcp-vnc --http --port 3000

MCP 端点随后可在 http://localhost:3000/mcp 访问。客户端配置示例：

{
  "mcpServers": {
    "vnc-controller": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

🛠️ 可用工具

MCP 服务器提供以下用于远程桌面控制的工具：

🖱️ 鼠标控制

示例： vnc_click(x=100, y=200, button="right", double=true)

示例： vnc_move_mouse(x=500, y=300)

⌨️ 键盘控制

支持的按键：

• 单个按键：a、Enter、F1、Escape、Up、Down、Tab、Space

• 组合键：Ctrl+c、Alt+F4、Ctrl+Alt+Delete、Shift+Tab

• 修饰键：Ctrl、Alt、Shift、Super/Win、Meta/Cmd

示例：

• vnc_key_press(key="Enter")

• vnc_key_press(key="Ctrl+Alt+Delete")

📝 文本输入

示例： vnc_type_text(text="Hello World!", enter=true)

示例： vnc_type_multiline(lines=["Line 1", "Line 2", "Line 3"])

📸 屏幕捕获

示例： vnc_screenshot(delay=1000) - 等待 1 秒后再截图

🤝 贡献

欢迎贡献！请随时提交拉取请求。

📄 许可证

本项目采用 MIT 许可证授权 - 详见 LICENSE 文件。