Metadata-Version: 2.4
Name: mcp-screenshot
Version: 1.0.0
Summary: MCP server for taking Wayland screenshots via grim/slurp. Part of likezara™ MCP suite.
Author-email: Kamaru <k.kamarux@gmail.com>
Maintainer-email: likezara <contact@likezara.com>
License: Proprietary — © 2026 likezara
Project-URL: Homepage, https://github.com/KamaruSama/mcp-screenshot
Project-URL: Repository, https://github.com/KamaruSama/mcp-screenshot
Project-URL: Issues, https://github.com/KamaruSama/mcp-screenshot/issues
Project-URL: Funding, https://ko-fi.com/kamaru
Keywords: mcp,screenshot,wayland,grim,slurp,likezara
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Multimedia :: Graphics :: Capture :: Screen Capture
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.27.0
Dynamic: license-file

# mcp-screenshot

**MCP server for taking Linux / Wayland screenshots via `grim` and `slurp`.**

Exposes 2 tools to capture the full screen, a selected region, or an interactive crop — returned inline as base64 or saved to disk.

📖 **[อ่านภาษาไทย →](README.th.md)**

---

## Tools

| Tool | Purpose |
|---|---|
| [`take_screenshot`](docs/en/tools/take_screenshot.md) | Capture screen (full / geometry / interactive select) |
| [`list_outputs`](docs/en/tools/list_outputs.md) | List available Wayland outputs / monitors |

---

## Requirements

- **Wayland** compositor (Sway, Hyprland, etc.)
- `grim` — screenshot tool
- `slurp` — interactive region selector
- `wlr-randr` *(optional)* — for `list_outputs`

Install on Arch Linux:
```bash
sudo pacman -S grim slurp wlr-randr
```

## Install

```bash
claude mcp add screenshot -s user \
  --env WAYLAND_DISPLAY=wayland-1 \
  --env XDG_RUNTIME_DIR=/run/user/1000 \
  -- /path/to/mcp-screenshot/.venv/bin/python /path/to/mcp-screenshot/server.py
```

Build the venv once:
```bash
cd /path/to/mcp-screenshot
uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python mcp
```

---

## Support the project ❤

- **Ko-fi:** https://ko-fi.com/kamaru

---

## Contact

- **Portfolio / general:** k.kamarux@gmail.com
- **Commercial / licensing:** contact@likezara.com

---

Copyright © 2026 **likezara™**. All rights reserved.
Developed by **Kamaru** (pen name).
