macOS屏幕视图和控制MCP服务器
提供窗口截图功能的模型上下文协议服务器。此服务器使LLM能够通过窗口标题或窗口ID捕获macOS上特定窗口的屏幕截图。
可用工具
capture_window_screenshot-按标题或ID捕获特定窗口的屏幕截图
- window_identifier （字符串，必填）：要搜索的窗口标题或窗口ID - search_in_owner （布尔值，可选）：是否在窗口所有者名称中搜索（默认值：true） - format （字符串，可选）：输出格式（二进制或base64）（默认：“二进制”）
list_windows-列出所有可见窗口
- 无需参数
find_window-按标题或所有者名称查找窗口
- title （字符串，必填）：要搜索的窗口标题或所有者名称 - search_in_owner （布尔值，可选）：是否在窗口所有者名称中搜索（默认值：true）
send_key-向活动窗口发送键盘按键事件
- key （字符串，必填）：要按的键（例如，“a”、“return”、“space”） - modifiers （字符串列表，可选）：要保留的修饰键列表（例如，\[“command”，“shift”\]）
type_text-键入文本字符序列
- text （string，必填）：要键入的文本 - delay （浮点数，可选）：按键之间的延迟（秒）（默认值：0.1）
支持的密钥
支持以下密钥：
- 字母：a-z（不区分大小写）
- 数字：0-9
- 特殊键：返回、制表符、空格、删除、转义
- 箭头键：上箭头、下箭头、左箭头、右箭头
- 修改键：命令、移位、控制、选项（也包括right_shift、right_option、right_control）
例子
发送一个按键：
await send_key("return")发送带有修饰符的密钥：
await send_key("c", ["command"]) # Command+C (copy)键入文本：
await type_text("Hello, World!")安装
使用pip
安装 macos_screen_mcp 通过pip：
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 server for capturing window screenshots",
"version": "1.0.0"
}
}调试
您可以使用MCP检查器调试服务器：
npx @modelcontextprotocol/inspector python -m macos_screen_mcp贡献
我们鼓励捐款以帮助扩展和改进macos屏幕mcp。无论您是想添加新工具、增强现有功能还是改进文档，您的意见都是有价值的。
欢迎拉取请求！欢迎贡献新想法、错误修复或增强功能，使macos screen mcp更加强大和有用。
许可证
macos屏幕mcp根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。