Claude Code KVM — MCP-сервер для Claude Code: управление VNC
Управляет удалённым рабочим столом через VNC: агент видит экран и нажимает клавиши, кликает мышью или вводит текст. Пригодится для задач в графическом интерфейсе.
claude mcp add claude-kvm -e VNC_HOST=<VNC_HOST> -e VNC_PORT=<VNC_PORT> -e VNC_USERNAME=<VNC_USERNAME> -e VNC_PASSWORD=<VNC_PASSWORD> -e CLAUDE_KVM_DAEMON_PATH=<CLAUDE_KVM_DAEMON_PATH> -- npx -y claude-kvmЧто делает Claude KVM
Claude KVM соединяет MCP-клиент с удалённым компьютером через VNC. JavaScript-прокси запускает нативный демон на Swift и C; тот захватывает экран и отправляет события мыши и клавиатуры. Для OCR используется Apple Vision, а координаты кликов переводятся из уменьшенного изображения в разрешение VNC-сервера.
Можно попросить агента найти элемент интерфейса, прочитать текст на экране и нажать нужную кнопку. Для работы нужны macOS на Apple Silicon, Node.js LTS, доступный VNC-сервер и значения VNC_HOST, VNC_PORT, VNC_USERNAME, VNC_PASSWORD и CLAUDE_KVM_DAEMON_PATH. Без настроенного VNC-подключения управлять будет нечем.
Какие задачи решает
- нажать кнопку в удалённом графическом интерфейсе
- прочитать текст на экране через OCR
- ввести текст в поле удалённого приложения
- перетащить элемент мышью на рабочем столе
Примеры запросов агенту
- Найди на удалённом экране кнопку сохранения и нажми её.
- Прочитай текст в окне и введи его в поле поиска.
- Перетащи файл в папку на удалённом рабочем столе.
Как установить Claude KVM
Командой платформы
claude mcp add claude-kvm -e VNC_HOST=<VNC_HOST> -e VNC_PORT=<VNC_PORT> -e VNC_USERNAME=<VNC_USERNAME> -e VNC_PASSWORD=<VNC_PASSWORD> -e CLAUDE_KVM_DAEMON_PATH=<CLAUDE_KVM_DAEMON_PATH> -- npx -y claude-kvmВместо <…> подставьте свои значения
Командой платформы
codex mcp add claude-kvm --env VNC_HOST=<VNC_HOST> --env VNC_PORT=<VNC_PORT> --env VNC_USERNAME=<VNC_USERNAME> --env VNC_PASSWORD=<VNC_PASSWORD> --env CLAUDE_KVM_DAEMON_PATH=<CLAUDE_KVM_DAEMON_PATH> -- npx -y claude-kvmВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"claude-kvm": {
"command": "npx",
"args": [
"-y",
"claude-kvm"
],
"env": {
"VNC_HOST": "<VNC_HOST>",
"VNC_PORT": "<VNC_PORT>",
"VNC_USERNAME": "<VNC_USERNAME>",
"VNC_PASSWORD": "<VNC_PASSWORD>",
"CLAUDE_KVM_DAEMON_PATH": "<CLAUDE_KVM_DAEMON_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"claude-kvm": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"claude-kvm"
],
"env": {
"VNC_HOST": "<VNC_HOST>",
"VNC_PORT": "<VNC_PORT>",
"VNC_USERNAME": "<VNC_USERNAME>",
"VNC_PASSWORD": "<VNC_PASSWORD>",
"CLAUDE_KVM_DAEMON_PATH": "<CLAUDE_KVM_DAEMON_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e VNC_HOST=<VNC_HOST> -e VNC_PORT=<VNC_PORT> -e VNC_USERNAME=<VNC_USERNAME> -e VNC_PASSWORD=<VNC_PASSWORD> -e CLAUDE_KVM_DAEMON_PATH=<CLAUDE_KVM_DAEMON_PATH> claude-kvm npx -y claude-kvmВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Claude KVM
Как установить Claude KVM в Codex?
Добавьте сервер командой `codex mcp add claude-kvm --env VNC_HOST=<VNC_HOST> --env VNC_PORT=<VNC_PORT> --env VNC_USERNAME=<VNC_USERNAME> --env VNC_PASSWORD=<VNC_PASSWORD> --env CLAUDE_KVM_DAEMON_PATH=<CLAUDE_KVM_DAEMON_PATH> -- npx -y claude-kvm`. Для работы также нужны macOS на Apple Silicon, Node.js LTS и доступ к VNC.
Что делает Claude KVM?
Подключает агента к удалённому рабочему столу через VNC. Агент может получать изображения экрана, распознавать текст и отправлять действия мышью и клавиатурой.
Как Claude KVM распознаёт текст на экране?
Для OCR сервер использует Apple Vision. Распознанный текст возвращается с координатами областей на уменьшенном изображении экрана.
