MCP (Model Context Protocol) サーバで、Sipeed NanoKVM デバイスの制御を行います。 これは、ClaudeのようなAIアシスタントがキーボード、マウス、電源ボタン、およびスクリーンキャプチャを介してリモートでハードウェアを制御することを可能にします。

NanoKVM とは?

NanoKVM は、RISC-V に基づくオープンソース、手頃な価格の IP-KVM デバイスです。 サーバ、組込みシステム、または任意のヘッドレスマシンを管理するために、BIOSレベルのコンピュータへのリモートアクセスを可能にします。

MCPとは?

モデルコンテキストプロトコルは、AIアシスタントを外部ツールやデータソースに接続するためのオープンスタンダードです。 このサーバーは、Claude などの AI アシスタントが使用できる MCP ツールとして NanoKVM の機能を公開しています。

##特徴

| カテゴリー | 能力 | 能力 | お問い合わせ |パワーコントロール | ATXヘッダによるパワーオン/オフ、リセット、パワーシャットダウン | |キーボード | タイプテキスト、キーコンビネーション(Ctrl+C、Alt+F4等) | |マウス/タッチ | クリック、移動、スクロール、絶対画面座標をタップ | |スクリーンショット | MJPEG動画ストリームからJPEGとして表示をキャプチャ | | ※ISOマウント** | リモートOS搭載用ISOマウント| |Monitoring | パワーLEDの状態、HDD活動、HDMI状態、解像度 |

インストール

ソースから

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

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

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: