mcpField
M
mcp-screenshot

mcp-screenshot

本地服务
github.com/KamaruSama媒体与设计028 周前更新
代码仓库

关于 mcp-screenshot

mcp-screenshot 是通过 grim 和 slurp 在 Linux Wayland 系统上截屏的 MCP 服务，支持全屏、区域和交互式裁剪，并可内联返回图像或保存到磁盘。

主要功能

  1. 01截取整个屏幕
  2. 02截取指定区域
  3. 03交互式选择裁剪范围
  4. 04以 base64 内联返回图像
  5. 05将截图保存到磁盘
  6. 06列出 Wayland 输出设备

适用场景

  1. 01截取整个桌面画面
  2. 02保存指定屏幕区域
  3. 03交互式选择截图范围

MCP 相关

向 MCP 客户端提供两个工具：截取屏幕，以及列出可用的 Wayland 输出设备或显示器。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "kamarusama-mcp-screenshot": {
      "command": "uvx",
      "args": [
        "mcp-screenshot"
      ],
      "env": {
        "WAYLAND_DISPLAY": "<WAYLAND_DISPLAY>",
        "XDG_RUNTIME_DIR": "<XDG_RUNTIME_DIR>"
      }
    }
  }
}
启动命令uvx mcp-screenshot
需要配置的环境变量
WAYLAND_DISPLAYWayland display identifier (e.g. wayland-1). Required for grim to find the compositor.
XDG_RUNTIME_DIRWayland runtime directory (e.g. /run/user/1000). Required for socket lookup.

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

安装包
pypimcp-screenshot1.0.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-screenshot

通过 grim 和 slurp 截取 Linux / Wayland 屏幕的 MCP 服务。

提供 2 个工具，用于截取全屏、选定区域或交互式裁剪 — 可以内嵌 base64 格式返回，也可保存到磁盘。

📖 阅读泰语版 →

工具

工具用途
take_screenshot截取屏幕（全屏 / 指定几何区域 / 交互式选择）
list_outputs列出可用的 Wayland 输出 / 显示器

要求

  • Wayland 合成器（Sway、Hyprland 等）
  • grim — 截图工具
  • slurp — 交互式区域选择器
  • wlr-randr （可选） — 用于 list_outputs

在 Arch Linux 上安装：

sudo pacman -S grim slurp wlr-randr

安装

claude mcp add screenshot -s user \
  --env WAYLAND_DISPLAY=wayland-1 \
  --env XDG_RUNTIME_DIR=/run/user/1000 \
  -- /path/to/mcp-screenshot/.venv/bin/python /path/to/mcp-screenshot/server.py

构建一次虚拟环境：

cd /path/to/mcp-screenshot
uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python mcp

支持本项目 ❤

联系方式

版权所有 © 2026 likezara™。保留所有权利。 由 Kamaru（笔名）开发。

评论

支持 Markdown

第一次接触 MCP？

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

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