Macos Screen MCP

🚀 macOS 屏幕視圖與控制 MCP 服務器

本項目是一個模型上下文協議（Model Context Protocol）服務器，它提供窗口截圖功能。藉助該服務器，大型語言模型（LLMs）能夠捕獲 macOS 上特定窗口的屏幕截圖，可通過窗口標題或窗口 ID 精準定位。

🚀 快速開始

本服務器提供了一系列實用工具，可對 macOS 上的窗口進行操作，以下是各工具的詳細介紹：

已提供的工具

• capture_window_screenshot：用於捕捉指定窗口的截圖，可通過窗口標題或 ID 識別。
  • window_identifier（字符串，必需）：要查找的窗口標題或窗口 ID。
  • search_in_owner（布爾值，可選）：是否在窗口所有者名稱中搜索（默認：true）。
  • format（字符串，可選）：輸出格式（二進制或 base64）（默認："binary"）。
• list_windows：列出所有可見窗口，無需參數。
• find_window：根據標題或所有者名稱查找窗口。
  • title（字符串，必需）：要查找的窗口標題或所有者名稱。
  • search_in_owner（布爾值，可選）：是否在窗口所有者名稱中搜索（默認：true）。
• send_key：向活動窗口發送鍵盤按鍵事件。
  • key（字符串，必需）：要按下的鍵（例如："a"、"return"、"space"）。
  • modifiers（字符串列表，可選）：按住的修飾鍵列表（例如：["command", "shift"]）。
• type_text：輸入一串文本字符。
  • text（字符串，必需）：要輸入的文本。
  • delay（浮點數，可選）：按鍵之間的延遲時間（以秒為單位，默認：0.1）。

支持的鍵

以下是本服務器支持的各類按鍵：

• 字母：a - z（不區分大小寫）。
• 數字：0 - 9。
• 特殊鍵：return、tab、space、delete、escape。
• 方向鍵：up_arrow、down_arrow、left_arrow、right_arrow。
• 修飾鍵：command、shift、control、option（還包括 right_shift、right_option、right_control）。

💻 使用示例

基礎用法

發送單個按鍵

await send_key("return")

帶有修飾符的按鍵

await send_key("c", ["command"])  # Command+C （複製）

輸入文本

await type_text("Hello, World!")

📦 安裝指南

使用 pip

您可以通過 pip 安裝 macos_screen_mcp，具體命令如下：

pip install git+ssh://git@github.com/jhead/macos-screen-mcp.git

安裝完成後，可使用以下命令將其作為腳本運行：

python -m macos_screen_mcp

📚 詳細文檔

配置

設置配置

您需要在 Claude 或 Cursor 設置中添加如下配置：

"mcpServers": {
 "macos-screen": {
    "name": "macos-screen",
    "url": "http://localhost:8000/sse",
    "description": "MCP 服務器用於捕獲窗口截圖",
    "version": "1.0.0"
  }
}

調試

您可以使用 MCP 檢查器來調試服務器，命令如下：

npx @modelcontextprotocol/inspector python -m macos_screen_mcp

貢獻

我們熱烈歡迎任何形式的貢獻，以幫助擴展和改進 macos - screen - mcp。無論您是想添加新功能、增強現有功能，還是改進文檔，您的意見都非常寶貴。歡迎提交拉取請求！請隨意提出新想法、錯誤修復或改進建議，讓 macos - screen - mcp 變得更強大、更實用。

📄 許可證

macos - screen - mcp 採用 MIT License 許可證。這意味著您可以自由使用、修改和分發該軟件，但需遵守 MIT License 的條款和條件。如需詳細信息，請參閱項目存儲庫中的 LICENSE 文件。