hyprland-mcp

Instructions

Implementation Reference

• hyprland_mcp/input.py:134-151 (handler)

  The core implementation of the key_press functionality that dispatches the command to hyprctl.

  async def key_press(keys: str, target: str | None = None) -> None:
      """Press a key combination using hyprctl dispatch sendshortcut.
  
      Args:
          keys: Key combo like "ctrl+c", "alt+F4", "Return", "super+1"
          target: Optional window selector
      """
      # Parse "ctrl+shift+c" into mods="CTRL SHIFT" and key="c"
      parts = keys.split("+")
      if len(parts) == 1:
          mods = ""
          key = parts[0]
      else:
          key = parts[-1]
          mods = " ".join(p.upper() for p in parts[:-1])
  
      target_str = target or ""
      await hyprctl.dispatch("sendshortcut", f"{mods}, {key}, {target_str}")

• hyprland_mcp/server.py:330-344 (registration)

  The MCP tool registration for key_press.

  @mcp.tool()
  async def type_text(text: str, delay_ms: int = 0) -> str:
      """Type text as if from a keyboard.
  
      Args:
          text: The text to type
          delay_ms: Delay between keystrokes in milliseconds (0 = instant)
      """
      from . import input as inp
      await inp.type_text(text, delay_ms=delay_ms)
      return f"Typed {len(text)} characters"
  
  
  @mcp.tool()
  async def key_press(keys: str, target: str | None = None) -> str: