MCP 工具参考

章节正在完善中

本页详细内容正在撰写。MCP 概览见 什么是 MCP。

完整 9 个工具的签名、参数、返回值。

screenshot_fullscreen

截取全屏。

参数:

名	类型	必填	说明
screen	number	否	显示器索引,默认 0(主屏)。-1 表示所有屏拼接
save_to_history	boolean	否	是否存历史,默认 true

返回: { image_base64, width, height, shot_id }

---

screenshot_region

截取指定坐标矩形。

参数:

名	类型	必填	说明
x	number	✅	左上角 x(虚拟桌面坐标)
y	number	✅	左上角 y
width	number	✅	宽
height	number	✅	高

返回: 同上

---

screenshot_active_window

截取当前活动窗口(自动获取窗口边界)。

参数: 无

返回: { image_base64, window_title, window_class, ... }

---

list_recent_shots

列出最近 N 张历史。

参数: { limit: number, offset: number }

返回: [{ shot_id, thumbnail_base64, created_at, tags, ocr_text_snippet }, ...]

---

get_shot

按 ID 取出完整截图。

参数: { shot_id: string }

返回: { image_base64, full_metadata }

---

search_shots

基于 OCR 文本的全文搜索。

参数: { query: string, limit?: number, tag?: string }

返回: 同 list_recent_shots,带匹配片段高亮

---

delete_shot

删除指定历史。

参数: { shot_id: string }

返回: { ok: boolean }

---

count_shots

统计历史数。

参数: { since?: ISO8601, tag?: string }

返回: { count: number }

---

annotate_image ⭐

让 AI 在图上画标注。

参数:

{
  "shot_id": "string  // 必填,指定要标注哪张",
  "annotations": [
    {
      "type": "rectangle | ellipse | arrow | line | highlight | text",
      "x": 100, "y": 100,
      "width": 200, "height": 50,
      "color": "#FF0000",
      "stroke_width": 3,
      "text": "(type=text 时必填)",
      "font_size": 16
    }
  ],
  "save_as_new": true
}

返回: { image_base64, new_shot_id? }

详细字段说明陆续补充。