snip-mcp

一个 MCP 服务器，让你可以将屏幕区域直接捕获到 Claude Code 对话中。使用热键或工具调用选择屏幕上的任何区域，截图将立即作为图像出现在上下文中。

功能

• 热键捕获 -- Ctrl+Shift+点击可随时随地打开截图覆盖层

• 工具触发捕获 -- Claude 可以代表你调用截图工具

• 多显示器支持 -- 适用于所有连接的显示器，并具备 DPI 感知能力

• 持久化存储 -- 截图保存到磁盘，服务器重启后依然存在

• 自动清理 -- 可配置的限制防止存储空间无限增长

• Toast 通知 -- 捕获截图时的视觉确认

Related MCP server: Shotik

要求

• Windows 10 或更高版本 (通过 ctypes 使用 Windows 特有的全局鼠标钩子)

• Python 3.11+

安装

git clone https://github.com/Alparse/snip-mcp.git
cd snip-mcp
pip install -e .

或者使用 uv：

git clone https://github.com/Alparse/snip-mcp.git
cd snip-mcp
uv pip install -e .

Claude Code 配置

将服务器添加到你的 Claude Code MCP 设置中。

如果通过 pip 安装 (全局或 venv)

在 ~/.claude/settings.json (全局) 或 .claude/settings.json (项目) 中：

{
  "mcpServers": {
    "snip": {
      "command": "snip-mcp"
    }
  }
}

如果使用 uv (推荐用于隔离)

{
  "mcpServers": {
    "snip": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/snip-mcp", "snip-mcp"]
    }
  }
}

使用方法

热键捕获

在屏幕任意位置按下 Ctrl+Shift+左键点击 以打开截图覆盖层：

1. 点击并拖动以选择区域

2. 松开鼠标进行捕获

3. 按 Escape 取消

Toast 通知会确认捕获成功。

工具触发捕获

让 Claude 截屏 -- 它将调用 snip_screen 工具并为你打开覆盖层。

管理截图

Claude 可以使用以下 MCP 工具：

配置

配置存储在 ~/.snip_mcp/config.json 中，并在首次运行时自动创建。

配置示例：

{
  "modifier_keys": ["ctrl", "shift"],
  "save_directory": "C:/Users/you/.snip_mcp/snips",
  "overlay_alpha": 0.3,
  "selection_color": "#00ff00",
  "selection_width": 2,
  "max_snips": 50
}

故障排除

"snip-mcp requires Windows" 此服务器使用 Windows 特有的 API (通过 ctypes 实现全局鼠标钩子)。它无法在 macOS 或 Linux 上运行。

"Failed to install mouse hook" 全局鼠标钩子可能需要提升权限。尝试以管理员身份运行终端。

覆盖层未出现 确保没有其他应用程序拦截了 Ctrl+Shift+点击。检查配置中的 modifier_keys。

高 DPI 显示器上的坐标偏移 服务器在启动时会调用 SetProcessDPIAware()。如果仍然看到偏移问题，请检查你的 Windows 显示缩放设置。

截图目录 默认情况下，截图存储在 ~/.snip_mcp/snips/ 中。你可以在 config.json 中更改此设置。

许可证

MIT -- 详情请参阅 LICENSE。