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標誌。