macOS 屏幕视图与控制 MCP 服务器

这是一个提供窗口截图功能的模型上下文协议服务器。此服务器允许大型语言模型通过窗口标题或窗口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许可证发布。这意味着您可以自由使用、修改和分发该软件，但需遵守MIT许可证中的条款和条件。更多详情，请参见项目存储库中的LICENSE文件。 </中文翻译>