carrot-mcp-sys

Carrot MCP System Server — screenshot capture for multimodal analysis.

Features

• Multi-monitor support: Capture individual monitors or all at once
• Region capture: Crop to any rectangular area using absolute screen coordinates
• Save to file: Optionally save captured images to disk
• MCP-compatible output: Returns base64-encoded PNG images ready for LLM processing

Tools

Installation

# From project root
uv sync --all-packages

# Or install standalone
pip install carrot-mcp-sys

Usage

Run as MCP server

carrot-mcp sys
python -m carrot_mcp_sys

Coordinate system

All coordinates are absolute screen pixels with origin (0,0) at the top-left corner of the virtual screen.

Monitor 1 (left):  left=0,    top=0, width=1920, height=1080
Monitor 2 (right): left=1920, top=0, width=2560, height=1440

Use list_monitors to discover each monitor's position.

Examples

Capture full monitor:

{"tool": "screenshot", "monitor": 1}

Capture an absolute region:

{"tool": "screenshot", "left": 1920, "top": 100, "width": 800, "height": 600}

Capture all monitors:

{"tool": "screenshot"}

Save to file:

{"tool": "screenshot", "monitor": 1, "save_path": "/tmp/capture.png"}

Output format

Returns list[TextContent | ImageContent]:

• First element: JSON metadata with status, timestamp, and monitors dict (keyed by monitor index)
• Remaining elements: One ImageContent per captured monitor (PNG image)

Example response structure:

[
  {
    "type": "text",
    "text": {
      "status": "ok",
      "timestamp": "2026-07-01T07:38:55.105440+00:00",
      "monitors": {
        "1": {
          "width": 1920, "height": 1080,
          "origin": {"left": 0, "top": 0},
          "bytes": 120887,
          "monitor": {"index": 1, "left": 0, "top": 0, "width": 1920, "height": 1080}
        }
      }
    }
  },
  {
    "type": "image",
    "data": "<base64 PNG>",
    "mimeType": "image/png"
  }
]

Dependencies

• mcp>=1.28.0
• mss>=9.0.0 — fast cross-platform screenshot library