MCP Windows Screenshots

🚀 MCP Windows Screenshots

这是一个MCP（模型上下文协议）服务器，它能让Claude从WSL2访问Windows的截图。非常适合与Claude Code无缝共享截图，无需手动查找文件。

🚀 快速开始

前提条件

• 安装了WSL2的Windows 10/11系统
• WSL2中安装了Node.js 18+
• 安装了Claude Code CLI

安装

在WSL2终端中运行以下命令：

claude mcp add windows-screenshots -s user \
  -e "WINDOWS_USERNAME=YourWindowsUsername" \
  -e "MCP_SCREENSHOT_DIRS=/mnt/c/Users/YourWindowsUsername/Pictures/Screenshots" \
  -- npx mcp-windows-screenshots@latest

请将YourWindowsUsername替换为你实际的Windows用户名。

示例

对于用户名为 "john" 且截图保存在OneDrive中的情况：

claude mcp add windows-screenshots -s user \
  -e "WINDOWS_USERNAME=john" \
  -e "MCP_SCREENSHOT_DIRS=/mnt/c/Users/john/OneDrive/Pictures/Screenshots" \
  -- npx mcp-windows-screenshots@latest

完成上述操作后，重启Claude Code即可使用。

使用方法

安装完成后，Claude可以使用以下功能：

查看最新截图

向Claude提问：“查看最新的截图” Claude会自动找到并查看该图像。

列出最近的截图

向Claude提问：“显示我最近的截图” Claude会使用mcp__windows-screenshots__list_screenshots来显示你最近的截图，并附带时间戳和大小信息。

查看截图目录

向Claude提问：“你正在哪些目录中查找截图？” Claude会使用mcp__windows-screenshots__list_directories来显示所有配置的路径。

✨ 主要特性

在WSL2中使用Claude Code时，共享Windows截图通常需要导航到类似/mnt/c/Users/...这样复杂的文件路径。而本工具将这个过程简化为以下几个步骤：

1. 在Windows上截取屏幕截图（使用Win + Shift + S）
2. 要求Claude显示你最新的截图
3. Claude会立即访问并显示该截图

无需再复制粘贴路径或在目录中导航！

📦 安装指南

环境变量

• WINDOWS_USERNAME：你的Windows用户名（默认为WSL用户名）
• MCP_SCREENSHOT_DIRS：自定义截图目录。如果有多个目录，请使用分号分隔：/path/1;/path/2

默认搜索位置

该工具会自动搜索以下常见位置：

• /mnt/c/Users/[username]/Pictures/Screenshots
• /mnt/c/Users/[username]/Pictures
• /mnt/c/Users/[username]/OneDrive/Pictures/Screenshots
• /mnt/c/Users/[username]/OneDrive/Pictures 2/Screenshots 1
• /mnt/c/Users/[username]/Documents/Screenshots
• /mnt/c/Users/[username]/Desktop
• /mnt/c/Users/[username]/AppData/Local/Temp

🔧 技术细节

开发

如果你想对本工具进行贡献或修改，可以按照以下步骤操作：

git clone https://github.com/rubinsh/mcp-windows-screenshots.git
cd mcp-windows-screenshots
npm install
npm run build

📄 许可证

本项目采用MIT许可证，版权归 rubinsh 所有。

🔧 故障排除

未找到截图

1. 验证你的Windows用户名是否正确。
2. 让Claude “列出截图目录”，查看正在搜索的路径。
3. 确保你的截图保存在其中一个被搜索的目录中。
4. 如果需要，可以使用MCP_SCREENSHOT_DIRS设置自定义目录。

工具不可用

1. 安装完成后重启Claude Code。
2. 运行claude mcp list验证服务器是否已安装。
3. 确保在添加服务器时使用了-s user。

环境变量不生效

确保你按照安装部分所示，在claude mcp add命令中使用了-e标志。