lkh081231/screenshot-feedback-hook-mcp

README excerpt

screenshot-feedback-hook-mcp 👁 中文 English 让 coding agent 看到自己产出的真实画面 —— 跨平台截图反馈工具（MCP server + Claude Code hook 双层）。 Let your coding agent see what it builds : a cross-platform (Windows / Linux / macOS) screenshot-feedback tool for AI agents, shipped as an MCP server plus a Claude Code hook helper. 为什么需要它 / Why Agent 写前端、画 EasyEDA/CAD 工程图时，没有视觉反馈就只能猜。给它一个「截图 → 看图 → 自我纠正」的回路，产出质量立刻不一样。 技术现实：Claude Code 的 hook 只能回传文本 ，而 MCP 工具可以回传原生图片 。所以本工具做成双层： 层 触发方式 图片如何进入 agent 视野 MCP server agent 主动调用 take screenshot 工具直接返回原生图片块（跨 MCP 客户端通用） Claude Code hook 某操作后自动触发 hook 回传截图的绝对路径，agent 用 Read 工具读图 DeepSeek Harness 插件 agent 主动调用，或操作后 / 轮次结束时自动触发 截图存进 dsh 的持久附件库，作为图片块直接进上下文， agent 什么都不用做 图片默认降采样（最长边 1568px）并按 字节预算 （ 80KB）迭代压缩 JPEG，避开 Claude Code 对 MCP 输出 25k token 的限制。 [!TIP] 推荐工程师 / 非程序员用户：直接让 AI agent 替你安装配置，没必要手动编辑 JSON。 在 Claude Code 里说一句「帮我安装并配置 screenshot-feedback-hook-mcp」，agent 会按下文 hook 配置 的提示先问清你的使用场景（看什么画面、渲染多久、何时截图），再替你写好 MCP + hook 配置。想自己动手的见下面的手动步骤。 安装 / Install 零安装运行（需要 uv）： 或常驻安装： pipx install screenshot-feedback-hook-mcp / uv tool install screenshot-feedback-hook-mcp 。 接入 MCP（推荐起点） Claude Code 一行： 或任意 MCP 客户端（Cursor / Cline / Windsurf...）的 mcp.json： 工具： - take screenshot(monit…

Category