SN

scgreenhalgh/nanokvm-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

14 stars 7 forks Качество 60 Тренд 20

Сервер 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 SDK
  • httpx - Async HTTP client
  • websockets - WebSocket client for real-time HID
  • pycryptodome - AES encryption for authentication
  • pillow - 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:

Открыть полный README на GitHub

Установка

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" } } } }