Install
$ agentstack add mcp-lfzds4399-cpu-claude-screen-mcp ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
claude-screen-mcp
An MCP server that exposes read-only screen state. Capture, OCR, and change detection only — no input control.
[](LICENSE) [](package.json) [](https://modelcontextprotocol.io) [](https://github.com/lfzds4399-cpu/claude-screen-mcp/actions/workflows/ci.yml)
Quick start
git clone https://github.com/lfzds4399-cpu/claude-screen-mcp
cd claude-screen-mcp
npm install
npm run build
claude mcp add screen -- node "$(pwd)/dist/index.js"
Restart the MCP host after registration.
Tools
| Tool | Purpose | |---|---| | screenshot | Capture a full display and resize the image result. | | screenshot_region | Capture a rectangular region. | | list_displays | Enumerate connected displays. | | list_windows | List visible top-level windows with optional title filter. | | read_screen_text | Run OCR on the full display or a region. | | find_text_on_screen | Search OCR text and return matching bounding boxes. | | screenshot_if_changed | Capture only when perceptual-hash distance exceeds a threshold. | | get_screen_diff | Return hash-distance diagnostics without an image. | | wait_for_change | Poll until the screen changes or a timeout elapses. | | record_screen | Sample a short interval and return deduplicated keyframes. |
Platform support
Windows 10+ is the primary target and is exercised on every release. macOS 11+ and Linux (X11 and Wayland) pass CI and smoke tests but are not regularly exercised. Window enumeration on macOS and Linux requires platform tooling; multi-monitor display enumeration is supported on Windows.
Security and privacy
All processing is local. No screenshot, OCR text, or telemetry leaves the machine; the only network call is the initial Tesseract language data download.
OCR output is untrusted input. Text rendered on screen may attempt to influence the model. Treat output as user-supplied data and avoid auto-executing commands derived from it. Scope read_screen_text to a window when full-desktop capture is not required.
Configuration
| Variable | Default | Purpose | |---|---|---| | SCREEN_MCP_LOG_LEVEL | info | debug, info, warn, or error. | | SCREEN_MCP_OCR_LANGS | eng+chi_sim | Tesseract language list (allowlist enforced). |
The first OCR call downloads language data (~10MB per language); subsequent calls reuse the local cache.
Development
npm install
npm run build
npm test
node tests/e2e-wire.mjs
Roadmap
screenshot_window(title)for direct single-window capture.- Improved multi-display enumeration on macOS and Linux.
License — MIT, see [LICENSE](LICENSE).
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: lfzds4399-cpu
- Source: lfzds4399-cpu/claude-screen-mcp
- License: MIT
- Homepage: https://www.npmjs.com/package/claude-screen-mcp
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.