claude-screen-mcp

Let Claude see your screen. MCP server for Windows + macOS + Linux. Zero native runtime deps.

Anthropic's official computer-use MCP server is macOS-only. This fills the gap for Windows + Linux users — and adds OCR (v0.2) and smart vision-diff (v0.3) so 24 h screen monitoring stays economical.

What you get (v0.1.0)

All tools work the same way on Windows (PowerShell + System.Drawing), macOS (screencapture), and Linux (grim / scrot / import).

Install

npm install -g claude-screen-mcp

Then register with Claude Code:

claude mcp add screen claude-screen-mcp

Or directly with node:

claude mcp add screen -- node /path/to/claude-screen-mcp/dist/index.js

Restart Claude Code, then ask: "Take a screenshot and tell me what's on my screen."

Why this exists

Anthropic's official Claude Code computer-use MCP server (v2.1.85+) is currently macOS-only. Windows and Linux users have no first-party way to give Claude vision into their desktop.

This server fills that gap with three deliberate constraints:

1. Zero native runtime deps — uses each OS's built-in screenshot tool. No node-gyp, no prebuilt binaries, no postinstall flakiness.

2. Single responsibility — only screen capture. Keyboard / mouse control belongs in a separate package (different threat model).

3. Token-aware — auto-resize to maxEdge=1600, JPEG / WebP support, region capture. Roadmap: OCR (skip vision entirely for text) and perceptual-hash diff (skip frames that didn't change).

Roadmap

• v0.1 — 4 core capture tools ✅

• v0.2 — OCR via tesseract.js. New tools: read_screen_text, find_text_on_screen. Cuts vision token cost ~15-30× when you only need text.

• v0.3 — Smart vision-diff via perceptual hash. New tools: screenshot_if_changed, get_screen_diff. Makes 24/7 monitoring economically viable (skip 90-99% of unchanged frames).

• v0.4 — screenshot_window(title) precisely scoped to a window's bounds.

Platform support

Windows is the primary tested platform (this is what the macOS-only gap is about). macOS / Linux are best-effort and welcome PRs.

Configuration

Environment variables:

Development

git clone <repo>
cd claude-screen-mcp
npm install
npm run build
node tests/e2e-wire.mjs    # smoke test all 4 tools

Security & privacy

• Server runs locally on your machine. No screenshot data leaves your machine via this server.

• Whatever client connects (Claude Code) controls where the image goes — that's the API call you authorized when you registered the connector.

• Use screenshot_region when you don't need the whole screen.

License

MIT — see LICENSE.

中文

让 Claude 看到你的屏幕。MCP server，Win/Mac/Linux 跨平台，零原生依赖。

Anthropic 官方 computer-use MCP 仅 macOS，这个项目填补 Windows + Linux 空白，外加 OCR (v0.2) 和 smart vision-diff (v0.3) 让 24h 屏幕监测经济上可行。

v0.1 含 4 个 tool

• screenshot — 截全屏，自动缩到 1600px（省 vision token）

• screenshot_region — 截 (x,y,w,h) 区域

• list_displays — 列所有显示器

• list_windows — 列所有可见窗口

安装

npm install -g claude-screen-mcp
claude mcp add screen claude-screen-mcp
# 重启 Claude Code，然后说"截一张屏幕给我看"

路线图

• v0.2 OCR (tesseract.js) — Claude 查屏幕文字不走 vision，省 token 15-30 倍

• v0.3 智能 vision-diff — 屏幕没变化时跳过截图，让 24/7 监测可行

• v0.4 窗口精确截图