MCP Server

io.github.Solteris-Dev/pir-mcp MCP Server

io.github.Solteris-Dev/pir-mcp

Repository Registry

What is the io.github.Solteris-Dev/pir-mcp MCP server?

Motion sensor for AI agents: tells when a screen region changes or goes still. Scores, never pixels.

How to install io.github.Solteris-Dev/pir-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

PIR_CAPTURE_CMD
Screenshot command template writing binary PPM to stdout; {x} {y} {w} {h} substituted. Default: grim (wlroots).
PIR_SELECT_CMD
Interactive rectangle selector printing 'x,y wxh'. Default: slurp. Empty disables the pick tools.
PIR_WINDOW_GEOMETRY_CMD
Prints 'x,y wxh' for window {id}. Default: Hyprland via jq. Empty disables window regions.
PIR_PICK_WINDOW_CMD
Interactive window pick printing the window id. Default: Hyprland + slurp.
PIR_MAX_WAIT_MS
Cap for blocking calls, ms (default 540000); keep under the host's MCP tool timeout.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pir-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pir-mcp"
      ],
      "env": {
        "PIR_CAPTURE_CMD": "<YOUR_PIR_CAPTURE_CMD>",
        "PIR_SELECT_CMD": "<YOUR_PIR_SELECT_CMD>",
        "PIR_WINDOW_GEOMETRY_CMD": "<YOUR_PIR_WINDOW_GEOMETRY_CMD>",
        "PIR_PICK_WINDOW_CMD": "<YOUR_PIR_PICK_WINDOW_CMD>",
        "PIR_MAX_WAIT_MS": "<YOUR_PIR_MAX_WAIT_MS>"
      }
    }
  }
}