macOS Screen View & Control MCP Server

Name: macOS Screen View & Control MCP Server
Author: jhead

@jhead

リポジトリ

macOS Screen View & Control MCP Server について

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

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

jhead

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

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://[email protected]/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

FAQ from macOS Screen View & Control MCP Server

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

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

How do I install and run the server?

Install via pip install git+ssh://[email protected]/jhead/macos-screen-mcp.git and run with python -m macos_screen_mcp. Debug using npx @modelcontextprotocol/inspector python -m macos_screen_mcp.

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).

Does the server support authentication?

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

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

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Servers

modelcontextprotocol

Model Context Protocol Servers

88.2K

Production-ready MCP integrations for AI applications

Klavis-AI

Klavis AI: MCP integration platforms that let AI agents use tools reliably at any scale

5.8K

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K