
scgreenhalgh/nanokvm-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Сервер MCP (Model Context Protocol) для управления устройствами Sipeed NanoKVM. Это позволяет помощникам ИИ, таким как Клод, удаленно управлять аппаратным обеспечением с помощью клавиатуры, мыши, кнопок питания и экрана.
Обзор
Сервер MCP (Model Context Protocol) для управления устройствами Sipeed NanoKVM. Это позволяет помощникам ИИ, таким как Клод, удаленно управлять аппаратным обеспечением с помощью клавиатуры, мыши, кнопок питания и захвата экрана. NanoKVM - это доступное IP-KVM устройство с открытым исходным кодом на основе RISC-V. Он позволяет удаленный доступ к компьютерам на уровне BIOS - идеально подходит для управления серверами, встроенными системами или любой безголовой машиной. Model Context Protocol является открытым стандартом для подключения помощников ИИ к внешним инструментам и источникам данных. Этот сервер раскрывает функциональность NanoKVM как инструменты MCP, которые могут использовать Клод и другие помощники ИИ. - Python 3.10+ - mcp - Model Context Protocol SDK - httpx - Async HTTP client - websockets - WebSocket client for real-time HID -pycryptodome - AES encryption for authentication - pillow - Image processing for screenshots Добавить в ~/Library/Application Support/Claude/claude desktop config.json (macOS) или %APPDATA%\Claude\claude desktop config.
Обзор (машинный перевод)
Сервер MCP (Model Context Protocol) для управления устройствами Sipeed NanoKVM. Это позволяет помощникам ИИ, таким как Клод, удаленно управлять аппаратным обеспечением с помощью клавиатуры, мыши, кнопок питания и захвата экрана.
Что такое NanoKVM?
NanoKVM - это доступное IP-KVM устройство с открытым исходным кодом на основе RISC-V. Он позволяет удаленный доступ к компьютерам на уровне BIOS - идеально подходит для управления серверами, встроенными системами или любой безголовой машиной.
Что такое MCP?
Model Context Protocol является открытым стандартом для подключения помощников ИИ к внешним инструментам и источникам данных. Этот сервер раскрывает функциональность NanoKVM как инструменты MCP, которые могут использовать Клод и другие помощники ИИ.
Особенности
| Категория | Возможности
Power Control | Включение/выключение питания, сброс, отключение силы через заголовок ATX | Keyboard | Тип текста, отправка комбинаций ключей (Ctrl+C, Alt+F4 и т.д.) | Мышь/Прикосновение | Нажмите, переместите, прокрутите, нажмите на абсолютные координаты экрана | | Скриншоты | Дисплей захвата в виде JPEG из видеопотока MJPEG | ISO Mounting | Изображения ISO для установки удаленной ОС Мониторинг | Статус светодиода питания, активность HDD, состояние HDMI, разрешение |
##Установка
Источник
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
NanoKVM MCP Server
An MCP (Model Context Protocol) server for controlling Sipeed NanoKVM devices. This enables AI assistants like Claude to remotely control hardware via keyboard, mouse, power buttons, and screen capture.
What is NanoKVM?
NanoKVM is an open-source, affordable IP-KVM device based on RISC-V. It allows remote access to computers at the BIOS level—perfect for managing servers, embedded systems, or any headless machine.
What is MCP?
Model Context Protocol is an open standard for connecting AI assistants to external tools and data sources. This server exposes NanoKVM functionality as MCP tools that Claude and other AI assistants can use.
Features
| Category | Capabilities |
|---|---|
| Power Control | Power on/off, reset, force shutdown via ATX header |
| Keyboard | Type text, send key combinations (Ctrl+C, Alt+F4, etc.) |
| Mouse/Touch | Click, move, scroll, tap at absolute screen coordinates |
| Screenshots | Capture display as JPEG from MJPEG video stream |
| ISO Mounting | Mount/unmount ISO images for remote OS installation |
| Monitoring | Power LED status, HDD activity, HDMI state, resolution |
Installation
From Source
git clone https://github.com/scgreenhalgh/nanokvm-mcp.git
cd nanokvm-mcp
pip install -e .
Dependencies
- Python 3.10+
mcp- Model Context Protocol SDKhttpx- Async HTTP clientwebsockets- WebSocket client for real-time HIDpycryptodome- AES encryption for authenticationpillow- Image processing for screenshots
Configuration
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
NANOKVM_HOST |
Yes | - | NanoKVM IP address or hostname |
NANOKVM_USER |
No | admin |
Web UI username |
NANOKVM_PASS |
No | admin |
Web UI password |
NANOKVM_SCREEN_WIDTH |
No | 1920 |
Target screen width in pixels |
NANOKVM_SCREEN_HEIGHT |
No | 1080 |
Target screen height in pixels |
NANOKVM_HTTPS |
No | false |
Use HTTPS instead of HTTP |
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"nanokvm": {
"command": "python",
"args": ["-m", "nanokvm_mcp.server"],
"env": {
"NANOKVM_HOST": "192.168.1.100",
"NANOKVM_USER": "admin",
"NANOKVM_PASS": "admin",
"NANOKVM_SCREEN_WIDTH": "1920",
"NANOKVM_SCREEN_HEIGHT": "1080"
}
}
}
}
Claude Code
Add to your Claude Code MCP configuration:
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"nanokvm": {
"command": "python",
"args": ["-m", "nanokvm_mcp.server"],
"env": {
"NANOKVM_HOST": "192.168.1.100",
"NANOKVM_USER": "admin",
"NANOKVM_PASS": "admin",
"NANOKVM_SCREEN_WIDTH": "1920",
"NANOKVM_SCREEN_HEIGHT": "1080"
}
}
}
}