scgreenhalgh/nanokvm-mcp

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

14 stars 7 forks 품질 60 트렌드 20

Sipeed NanoKVM 장치를 제어하기위한 MCP (모델 Context Protocol) 서버. 이것은 Claude와 같은 AI 조수가 키보드, 마우스, 전원 버튼 및 화면을 통해 원격 제어 하드웨어와 같은...

개요

Sipeed NanoKVM 장치를 제어하기위한 MCP (모델 Context Protocol) 서버. 키보드, 마우스, 전원 버튼, 화면 캡처를 통해 원격 제어 하드웨어와 같은 AI 조수가 가능합니다. NanoKVM은 RISC-V를 기반으로 한 오픈 소스, 저렴한 IP-KVM 장치입니다. 그것은 BIOS 수준에서 컴퓨터에 원격 액세스를 허용 - 서버 관리, 임베디드 시스템, 또는 어떤 헤드리스 기계. Model Context Protocol은 외부 도구 및 데이터 소스에 AI 보조를 연결하는 개방형 표준입니다. 이 서버는 Claude 및 기타 AI 조수가 사용할 수있는 MCP 도구로 NanoKVM 기능을 노출합니다. - Python 3.10+ - mcp - Model Context Protocol SDK - HTTPx - Async HTTP 클라이언트 - websocket - 실시간 HID를 위한 WebSocket 클라이언트 - pycryptodome - AES 암호화 인증 - 베개 - 스크린 샷 처리 ~/Library/Application Support/Claude/claude desktop config.json (macOS) 또는 %APPDATA%\Claude\claude desktop config에 추가하십시오.

개요(AI 번역)

Sipeed NanoKVM 장치를 제어하기위한 MCP (모델 Context Protocol) 서버. 키보드, 마우스, 전원 버튼, 화면 캡처를 통해 원격 제어 하드웨어와 같은 AI 조수가 가능합니다.

나노KVM은 무엇입니까?

NanoKVM은 RISC-V를 기반으로 한 오픈 소스, 저렴한 IP-KVM 장치입니다. 그것은 BIOS 수준에서 컴퓨터에 원격 액세스를 허용 - 서버 관리, 임베디드 시스템, 또는 어떤 헤드리스 기계.

MCP는 무엇입니까?

Model Context Protocol은 외부 도구 및 데이터 소스에 AI 보조를 연결하는 개방형 표준입니다. 이 서버는 Claude 및 기타 AI 조수가 사용할 수있는 MCP 도구로 NanoKVM 기능을 노출합니다.

특징

분류	능력
Power Control	파워 온/오프, 리셋, 파워 셧다운
Keyboard	유형 텍스트, 키 조합(Ctrl+C, Alt+F4 등)
Mouse/Touch	클릭, 이동, 스크롤, 절대 화면 좌표로 탭
Screenshots	MJPEG 비디오 스트림의 JPEG 캡처 디스플레이
ISO 설치	원격 OS 설치용 마운트/unmount ISO 이미지
Monitoring	파워 LED 상태, HDD 활동, HDMI 상태, 해상도

설치

출처에서

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

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:

GitHub에서 전체 README 보기

설치

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