mcpField
P
pikvm

pikvm

github.com/okou-ai云与 DevOps81123 次安装1 周前更新
代码仓库

关于 pikvm

pikvm 技能提供通过 PiKVM API 远程查看屏幕、模拟键鼠输入和控制 ATX 电源的操作指南，适用于需要管理连接设备的自动化流程。

主要功能

  1. 01获取屏幕截图
  2. 02输入文本与按键组合
  3. 03移动、点击和滚动鼠标
  4. 04查询设备与 ATX 状态
  5. 05控制设备电源

适用场景

  1. 01远程查看连接设备画面
  2. 02执行键盘和鼠标操作
  3. 03检查设备信息与电源状态

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/okou-ai/okou-skills --skill pikvm

安装后在 Claude Code 中输入/pikvm确认已加载。

详细介绍

坐标系

鼠标坐标以屏幕中心为原点（0,0）：

  • X 负值 = 左，X 正值 = 右
  • Y 负值 = 上，Y 正值 = 下

对于 1920x1080 屏幕：

  • 左上角：(-960, -540)
  • 中心：(0, 0)
  • 右下角：(960, 540)

用法

截取屏幕截图
curl -k -s -o /tmp/screenshot.jpg -u "$PIKVM_AUTH" "$PIKVM_URL/api/streamer/snapshot"
输入文本

文本必须以原始正文形式发送，并设置 Content-Type: text/plain：

curl -k -s -X POST \
  -H "Content-Type: text/plain" \
  -u "$PIKVM_AUTH" \
  -d "Hello World" \
  "$PIKVM_URL/api/hid/print?limit=0"
移动鼠标

移动到绝对位置（0,0 = 屏幕中心）：

curl -k -s -X POST \
  -u "$PIKVM_AUTH" \
  "$PIKVM_URL/api/hid/events/send_mouse_move?to_x=-500&to_y=-300"
鼠标点击
# Press
curl -k -s -X POST \
  -u "$PIKVM_AUTH" \
  "$PIKVM_URL/api/hid/events/send_mouse_button?button=left&state=true"

# Release
curl -k -s -X POST \
  -u "$PIKVM_AUTH" \
  "$PIKVM_URL/api/hid/events/send_mouse_button?button=left&state=false"
按下按键

先设置 state=true 按下，再设置 state=false 释放：

# Press Enter
curl -k -s -X POST \
  -u "$PIKVM_AUTH" \
  "$PIKVM_URL/api/hid/events/send_key?key=Enter&state=true"

curl -k -s -X POST \
  -u "$PIKVM_AUTH" \
  "$PIKVM_URL/api/hid/events/send_key?key=Enter&state=false"
按键组合（例如，按 Cmd+Space 打开 Spotlight）

按顺序按下所有按键，然后按相反顺序释放：

# Press Cmd
curl -k -s -X POST -u "$PIKVM_AUTH" "$PIKVM_URL/api/hid/events/send_key?key=MetaLeft&state=true"

# Press Space
curl -k -s -X POST -u "$PIKVM_AUTH" "$PIKVM_URL/api/hid/events/send_key?key=Space&state=true"

# Release Space
curl -k -s -X POST -u "$PIKVM_AUTH" "$PIKVM_URL/api/hid/events/send_key?key=Space&state=false"

# Release Cmd
curl -k -s -X POST -u "$PIKVM_AUTH" "$PIKVM_URL/api/hid/events/send_key?key=MetaLeft&state=false"
鼠标滚动
curl -k -s -X POST \
  -u "$PIKVM_AUTH" \
  "$PIKVM_URL/api/hid/events/send_mouse_wheel?delta_x=0&delta_y=-50"
获取设备信息
curl -k -s \
  -u "$PIKVM_AUTH" \
  "$PIKVM_URL/api/info" | jq .
ATX 电源控制
# Power on
curl -k -s -X POST \
  -u "$PIKVM_AUTH" \
  "$PIKVM_URL/api/atx/power?action=on"

# Power off
curl -k -s -X POST -u "$PIKVM_AUTH" "$PIKVM_URL/api/atx/power?action=off"

# Hard reset
curl -k -s -X POST -u "$PIKVM_AUTH" "$PIKVM_URL/api/atx/power?action=reset_hard"

常见按键名称

MetaLeft (Cmd), ControlLeft, AltLeft, ShiftLeft
Enter, Space, Escape, Tab, Backspace, Delete
ArrowUp, ArrowDown, ArrowLeft, ArrowRight
KeyA-KeyZ, Digit0-Digit9, F1-F12
PageUp, PageDown, Home, End
Equal (+), Minus (-)

API 端点参考

端点方法说明
/api/streamer/snapshotGET屏幕截图（JPEG）
/api/hid/printPOST输入文本（正文：原始文本）
/api/hid/events/send_mouse_movePOST移动鼠标（to_x、to_y）
/api/hid/events/send_mouse_buttonPOST点击（button、state）
/api/hid/events/send_mouse_wheelPOST滚动（delta_x、delta_y）
/api/hid/events/send_keyPOST按键（key、state）
/api/atx/powerPOST电源控制（action）
/api/infoGET设备信息
/api/atxGETATX 状态

API 参考

评论

支持 Markdown