Skip to main content
Glama

rudycanshoot

An MCP server + CLI that lets AI assistants take and view screenshots. Works with Claude Code, Cursor, Windsurf, Codex CLI, Gemini CLI, OpenCode, Continue, Cline, Aider, and GitHub Copilot.

Install

npm install -g rudycanshoot

Or run without installing:

npx rudycanshoot serve

Related MCP server: webdev-mcp

Quick Start

1. Auto-configure your AI tools

# All tools at once
rudycanshoot install --all

# Or a specific tool
rudycanshoot install --tool claude-code
rudycanshoot install --tool cursor
rudycanshoot install --tool windsurf
rudycanshoot install --tool codex
rudycanshoot install --tool gemini
rudycanshoot install --tool opencode
rudycanshoot install --tool continue
rudycanshoot install --tool cline

2. Restart your AI tool

The MCP server will now appear in your AI assistant's tool list.

3. Use it

Ask your AI: "Take a screenshot and show me what's on screen."


MCP Tools

Tool

Description

take_screenshot

Capture fullscreen, active window, or a region

read_screenshot

Read a saved image so the AI can view it

list_screenshots

List recent captures

take_screenshot parameters

Parameter

Type

Default

Description

mode

fullscreen|window|area

fullscreen

What to capture

area

string

x,y,width,height — required when mode=area

filename

string

auto

Output filename

outputDir

string

~/.rudycanshoot/captures/

Where to save


CLI

# Take a screenshot
rudycanshoot capture
rudycanshoot capture --mode window
rudycanshoot capture --mode area --area 0,0,1920,1080
rudycanshoot capture --output /tmp/snap.png

# List recent screenshots
rudycanshoot list

# Start MCP server (used by AI tools — usually run automatically)
rudycanshoot serve

# Configure AI tools
rudycanshoot install --all

Supported AI Tools

Tool

Config location

What's installed

Claude Code

~/.claude/settings.json

MCP server entry + /screenshot command

Cursor

~/.cursor/mcp.json

MCP server entry

Windsurf

~/.codeium/windsurf/mcp_config.json

MCP server entry

Codex CLI

~/AGENTS.md

Tool documentation

Gemini CLI

~/.gemini/settings.json

MCP server entry

OpenCode

~/.config/opencode/opencode.json

MCP server + agent

Continue

~/.continue/config.json

MCP server entry

Cline

~/.clinerules/

Rules file

Aider

~/.aider.conf.yml

Comment reference

GitHub Copilot

~/.github/copilot-instructions.md

Instructions


Screenshot Backends

Linux

Installed automatically when available, in priority order:

Tool

Display

Install

grim

Wayland

sudo apt install grim

scrot

X11

sudo apt install scrot

maim

X11

sudo apt install maim

import

X11

sudo apt install imagemagick

xwd

X11

sudo apt install x11-apps

macOS

Uses the built-in screencapture command — no extra install needed.

Windows

Uses PowerShell + System.Windows.Forms — no extra install needed.


Project Config Files (for contributors)

When you clone this repo, your AI tool will auto-discover:

File

Tool

CLAUDE.md

Claude Code

AGENTS.md

Codex CLI, OpenCode

GEMINI.md

Gemini CLI

.github/copilot-instructions.md

GitHub Copilot

.cursor/mcp.json

Cursor

.mcp.json

Claude Code (project-level)

.windsurfrules

Windsurf

.clinerules/

Cline

.claude/commands/screenshot.md

Claude Code /screenshot command

.opencode/agents/screenshot.md

OpenCode agent


License

MIT


Image Processing

Function

Description

annotateImage

Add text label to a screenshot

diffScreenshots

Highlight/heatmap/side-by-side diff

compareScreenshots

Pixel-level similarity metrics

highlightRegions

Color overlays with labels

redactRegions

Fill or blur sensitive areas

addWatermark

Corner text watermark

addBorder

Solid border with optional radius

cropImage

Crop to a region

resizeImage

Resize preserving aspect ratio

stitchImages

Horizontal or vertical concat

makeGrid

N×M grid composite

makeGif

Animated GIF from PNG frames

ocrImage

Extract text via Tesseract

Pipeline API

import { Pipeline } from "rudycanshoot";

const path = await Pipeline.capture({ mode: "fullscreen" })
  .annotate("CT-6101 Boson capture", { position: "bottom" })
  .redact([{ x: 0, y: 0, w: 1920, h: 30 }], { style: "blur" })
  .watermark("CONFIDENTIAL", { corner: "br" })
  .save("/tmp/final.png");
A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jrb00013/rudycanshoot'

If you have feedback or need assistance with the MCP directory API, please join our Discord server