JinDaGe - mcp-windows-screenshots MCP Details

article

README

🚀 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/...这样复杂的文件路径。而本工具将这个过程简化为以下几个步骤：

在Windows上截取屏幕截图（使用Win + Shift + S）
要求Claude显示你最新的截图
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 所有。

🔧 故障排除

未找到截图

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

工具不可用

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

环境变量不生效

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

mcp-windows-screenshots