macOS Screen View & Control MCP Server

macOS 屏幕查看与控制 MCP 服务

一个提供窗口截图功能的模型上下文协议服务。此服务可让大模型按窗口标题或窗口 ID 捕获 macOS 上特定窗口的截图。

可用工具

• capture_window_screenshot - 按窗口标题或 ID 捕获特定窗口的截图

  • window_identifier（string，必填）：要搜索的窗口标题或窗口 ID
  • search_in_owner（boolean，可选）：是否搜索窗口所属应用名称（默认：true）
  • format（string，可选）：输出格式（binary 或 base64）（默认："binary"）

• list_windows - 列出所有可见窗口

  • 无需参数

• find_window - 按标题或所属应用名称查找窗口

  • title（string，必填）：要搜索的窗口标题或所属应用名称
  • search_in_owner（boolean，可选）：是否搜索窗口所属应用名称（默认：true）

• send_key - 向活动窗口发送键盘按键事件

  • key（string，必填）：要按下的按键（例如，'a'、'return'、'space'）
  • modifiers（字符串列表，可选）：要按住的修饰键列表（例如，['command', 'shift']）

• type_text - 输入一串文本字符

  • text（string，必填）：要输入的文本
  • delay（float，可选）：每次按键之间的延迟秒数（默认：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 (copy)

输入文本：

await type_text("Hello, World!")

安装

使用 pip

通过 pip 安装 macos_screen_mcp：

pip install git+ssh://[email protected]/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 server for capturing window screenshots",
    "version": "1.0.0"
  }
}

调试

你可以使用 MCP 检查器调试服务：

npx @modelcontextprotocol/inspector python -m macos_screen_mcp

贡献

我们欢迎大家贡献力量，帮助扩展和改进 macos-screen-mcp。无论你想添加新工具、增强现有功能，还是改进文档，你的贡献都很有价值。

欢迎提交拉取请求！欢迎贡献新想法、错误修复或增强功能，让 macos-screen-mcp 更加强大和实用。

许可证

macos-screen-mcp 根据 MIT 许可证授权。这意味着你可以自由使用、修改和分发此软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。