MCP.so
登录

macOS Screen View & Control MCP Server

@jhead

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

jhead

关于 macOS Screen View & Control MCP Server

MCP Server to screenshot and control macOS windows (made for Cursor)

macOS Screen View & Control MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "macos-screen-mcp": {
      "command": "python",
      "args": [
        "-m",
        "macos_screen_mcp"
      ]
    }
  }
}

macOS Screen View & Control MCP Server 工具

5

Captures a screenshot of a specific window by its title or ID

Lists all visible windows

Finds a window by title or owner name

Sends a keyboard key press event to the active window

Types a sequence of text characters

概览

What is macOS Screen View & Control MCP Server?

A Model Context Protocol server for macOS that enables LLMs to capture screenshots of specific windows by title or ID, list visible windows, find windows, and send keyboard input. It is designed for developers and AI agents needing visual or interactive access to macOS windows.

How to use macOS Screen View & Control MCP Server?

Install via pip (pip install git+ssh://git@github.com/jhead/macos-screen-mcp.git) and run with python -m macos_screen_mcp. Configure the server URL (e.g., http://localhost:8000/sse) in Claude or Cursor settings under mcpServers. Use the provided tools: capture_window_screenshot, list_windows, find_window, send_key, and type_text.

Key features of macOS Screen View & Control MCP Server

  • Capture screenshots of windows by title or ID
  • List all visible windows on macOS
  • Find windows by title or owner name
  • Send keyboard key presses with modifier support
  • Type sequences of text with configurable keystroke delay

Use cases of macOS Screen View & Control MCP Server

  • An AI assistant screenshotting a specific application window for analysis
  • Automating window discovery and interaction on macOS
  • Sending keyboard shortcuts (e.g., Command+C) to active windows
  • Typing text into input fields programmatically
  • Debugging window state by listing visible windows

常见问题

1

What tools does macOS Screen View & Control MCP Server provide?

It provides `capture_window_screenshot`, `list_windows`, `find_window`, `send_key`, and `type_text`.

2

How do I install and run the server?

Install via `pip install git+ssh://git@github.com/jhead/macos-screen-mcp.git` and run with `python -m macos_screen_mcp`. Debug using `npx @modelcontextprotocol/inspector python -m macos_screen_mcp`.

3

What keys are supported for `send_key`?

Supported keys include letters a‑z, numbers 0‑9, return, tab, space, delete, escape, arrow keys, and modifier keys (command, shift, control, option, and their right variants).

4

Does the server support authentication?

No. The configuration uses a local HTTP URL (`http://localhost:8000/sse`) without any authentication mechanism mentioned.

5

On which operating systems does it run?

The server is explicitly for macOS; it uses macOS‑specific window APIs (e.g., window titles, screenshots) and does not support other operating systems.

评论

其他 分类下的更多 MCP 服务器