Screeny

🚀 Screeny MCP Server：優先保障隱私的 macOS 截圖工具，為 AI 代理服務

Screeny MCP Server 是一款專為 macOS 系統打造的 MCP 服務器，它將隱私保護置於首位。藉助該工具，AI 代理能夠對預先批准的應用程序窗口進行截圖操作，為開發和調試工作提供安全可靠的可視化上下文信息。

⚠️ 重要提示

使用本工具需要具備 屏幕截圖權限 並完成 窗口批准設置，具體說明請參考下文。

🚀 快速開始

使用 Screeny MCP Server 前，請確保你已完成以下操作：

1. 授予屏幕截圖權限。
2. 完成窗口批准設置。

✨ 主要特性

🔒 優先保障隱私的設計

與其他截圖工具不同，Screeny 在進行截圖操作前，需要用戶對每個窗口進行 明確授權：

• 窗口批准系統：僅能對預先批准的窗口（在設置過程中完成批准）進行截圖。
• 用戶可控訪問：用戶可以自主決定哪些窗口可以被訪問。
• 非侵入式截圖：在後臺進行截圖操作，不會改變窗口焦點，也不會干擾用戶的工作流程。
• 無外部連接：Screeny 完全在本地設備上運行，截圖使用完畢後會立即刪除。

豐富的工具集

• listWindows：列出所有已批准的、可用於截圖的應用程序窗口。
  • 僅顯示用戶批准的窗口。
• takeScreenshot：根據窗口 ID 對特定窗口進行截圖。
  • 後臺截圖：無需將窗口置於前臺，但無法對最小化的窗口進行截圖。
  • 提供真實像素數據：提供高保真度的圖像，而非 OCR 或文本提取結果。
  • 可壓縮圖像：必要時，可將大尺寸圖像壓縮至 1MB 以內。

資源鏈接

• screeny://info：提供服務器信息和配置詳情。

📦 安裝指南

安裝依賴

你可以使用 pipx 或 uvx 進行安裝：

pipx install mcp-server-screeny

{
  "mcpServers": {
    "screeny": {
      "command": "mcp-server-screeny",
      "args": []
    }
  }
}

{
  "mcpServers": {
    "screeny": {
      "command": "uvx",
      "args": ["mcp-server-screeny"]
    }
  }
}

不同客戶端配置

Claude Desktop

1. 打開 Claude 設置 → 開發者 → 編輯配置。
2. 添加上述配置信息。
3. 保存配置後，重啟 Claude Desktop。

Cursor

1. 打開 Cursor 設置 → 工具與集成 → MCP 工具。
2. 添加上述配置信息。
3. 保存配置後，重啟 Cursor。

📚 詳細文檔

🔧 設置步驟

1. 授予屏幕截圖權限（必需）

重要提示：請在進行窗口批准設置前授予此權限。

⚠️ 重要提示

你需要同時為以下兩個應用程序授予屏幕截圖權限：

1. 終端應用程序（如 Terminal.app、iTerm2 等）：運行設置時必需（設置完成後可禁用）。
2. MCP 主機應用程序（如 Claude Desktop、Cursor）：進行截圖操作時必需。

授予權限的步驟如下：

1. 打開 系統設置 > 隱私與安全 > 屏幕與系統音頻錄製。
2. 點擊 "+" 按鈕。
3. 添加終端應用程序和 MCP 主機應用程序。
4. 授予權限後，重啟這兩個應用程序。

2. 窗口批准設置（必需）

完成 MCP 客戶端配置後，你可以批准可進行截圖的窗口。

# 交互式批准
mcp-server-screeny --setup

# 自動批准所有當前窗口
mcp-server-screeny --setup --allow-all

# 交互式批准
uvx mcp-server-screeny --setup

# 自動批准所有當前窗口
uvx mcp-server-screeny --setup --allow-all

批准信息將保存至 ~/.screeny/approved_windows.json 文件中。若需要更新批准窗口列表，請重新運行設置命令。

🔒 安全與隱私保障

• 僅能對用戶批准的窗口進行截圖。
• 所有處理操作均在本地設備上進行。
• 截圖為臨時文件，使用完畢後將立即刪除。

🛠️ 故障排除

權限問題

# 測試窗口檢測和權限
mcp-server-screeny --debug

# 若窗口發生變化，重新運行設置
mcp-server-screeny --setup

常見問題及解決方案

• "spawn uvx ENOENT" 錯誤
  • 解決方案：在 MCP 配置中使用 uvx 的完整路徑，而非 "uvx"。
  • 查找路徑命令：which uvx。
  • 示例路徑："/opt/homebrew/bin/uvx" 或 "/usr/local/bin/uvx"。
• "No approved windows found"
  • 解決方案：先運行 mcp-server-screeny --setup 命令（若使用 uvx，則運行 uvx mcp-server-screeny --setup）。
• "Screen Recording permission required" 或 "No windows found"
  • 解決方案：在系統設置 > 隱私與安全 > 屏幕與系統音頻錄製中授予屏幕錄製權限。
    • 點擊 "+" 按鈕，手動添加 MCP 主機應用程序（如 Claude Desktop、Cursor 等）。
    • 授予權限後，重啟 MCP 主機應用程序。
  • 授予權限後，嘗試重新運行設置命令。

🤝 貢獻代碼

歡迎提交拉取請求！你可以自由貢獻新的想法、修復漏洞或進行功能增強。

這是我的第一個 MCP 項目，如果你遇到任何問題，請提交 issue，我會盡力修復！

📋 系統要求

• Python 3.10 及以上版本
• macOS 系統
• 屏幕截圖權限

📄 許可證

本項目採用 MIT 許可證。