mcpField
S
shotlog

shotlog

本地服务
github.com/Marlon-Trujillo-Jaramillo生产力04 天前更新
代码仓库

关于 shotlog

shotlog 是供 AI 助手使用的 macOS MCP 服务，可按顺序记录窗口截图并添加说明。它将截图整理为 Markdown 报告，适用于实验记录、QA 证据、教程、操作手册和错误报告。

主要功能

  1. 01截取指定窗口
  2. 02为截图编号并添加说明
  3. 03事后修改截图说明
  4. 04通过 SCP 导入远程截图
  5. 05导出有序 Markdown 报告

适用场景

  1. 01记录大学实验的操作步骤
  2. 02收集 QA 证据
  3. 03制作截图教程
  4. 04准备操作手册或错误报告

MCP 相关

MCP 服务提供窗口列表、截图捕获与管理、通过 SCP 导入远程截图以及导出 Markdown 报告等工具。它可连接 Claude Code、Claude Desktop 等 MCP 客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "marlon-trujillo-jaramillo-shotlog": {
      "command": "uvx",
      "args": [
        "shotlog-mcp"
      ],
      "env": {
        "SHOTLOG_DIR": "<SHOTLOG_DIR>"
      }
    }
  }
}
启动命令uvx shotlog-mcp
需要配置的环境变量
SHOTLOG_DIRFolder for screenshots, manifest.json and report.md (default: ~/shotlog)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypishotlog-mcp0.1.1

工具

6

收录的工具列表 · 更新于 3 天前

此工具无需参数。

详细介绍

shotlog-mcp

让你的 AI 助手为报告截取屏幕截图。

一个适用于 macOS 的 MCP 服务。它会截取指定窗口，将截图按顺序编号并附上说明（活动、命令、结果），然后汇总成一份 Markdown 报告，你可以将其转换为 PDF。

它最初是为一门大学操作系统实验课开发的：在 Mac 和 Windows 笔记本上同时操作时，每个步骤都必须配有屏幕截图。它同样适用于 QA 证据、教程、操作手册和错误报告。

阅读西班牙语版

shotlog 演示：助手将 Terminal 窗口截为第 1 步，并导出报告

功能

工具描述
list_windows列出可见窗口（应用、标题、尺寸）。
save_screenshot按应用和／或标题选择并截取一个窗口（默认选择最前方的窗口），并将截图保存为 001_name.png，同时附上说明。
update_caption事后补充或修正说明。
list_screenshots按顺序显示截图记录。
pull_remote_screenshots通过 SCP 从另一台机器获取新截图（例如 Windows 的 Pictures\Screenshots），并按相同顺序编号。
export_report写入 report.md：按顺序列出每张截图及其说明。

然后只需提出请求：“在终端中运行 ssh -V，为其截屏，并将说明写为第 3 步。”

安装

需要 macOS、Python 3.11+ 和 uv。

Claude Code

claude mcp add shotlog -- uvx shotlog-mcp

Claude Desktop／其他 MCP 客户端

{
  "mcpServers": {
    "shotlog": { "command": "uvx", "args": ["shotlog-mcp"] }
  }
}

首次截屏时，运行服务的应用（Terminal、iTerm、VS Code、Claude 等）需要获得屏幕录制权限：系统设置 → 隐私与安全性 → 屏幕录制。

配置

变量默认值
SHOTLOG_DIR~/shotlog保存屏幕截图、manifest.json 和 report.md 的位置。

每个项目使用一个文件夹：claude mcp add shotlog -e SHOTLOG_DIR=~/lab3/shots -- uvx shotlog-mcp

远程屏幕截图（可选）

要使用 pull_remote_screenshots，另一台机器需要运行 SSH 服务（Windows：设置 → 可选功能 → OpenSSH Server），并允许从 Mac 使用密钥登录，这样就不会提示输入密码。

将报告转换为 PDF

cd ~/shotlog && pandoc report.md -o report.pdf

开发

uv run --group dev pytest

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。