💻 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 секунду перед захватом

🤝 Участие в разработке

Вклад приветствуется! Не стесняйтесь отправлять Pull Request.

📄 Лицензия

Этот проект лицензирован под MIT License — подробности см. в файле LICENSE.