개요

https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e] [T0]] [T0]] [T0]] [T0]] [T0]] [T0]] [T0]] [T0] [T0] [T0]] [T0] [T0] [T0]] [T0]] [T0] [T0] [T0] [T0] [T0]] [T0] [T0]] [T0] [T0] [T0]] [T0]] [T0] [T0] [T0]] https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e] https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e]]] https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e]]]]]] [[https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e]]]]]]] [[[[[[https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e]]]]]]]]]]]]]] [[[[[[[https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e]]]]]]]]]]]]]]]]]] [[[[[[[[[[[[[[[[[[[[[[ HYprctl의 모든 기능을 노출하는 경량, 비공식 모델 Context Protocol (MCP) 서버 - Hyprland Wayland 작곡가를위한 명령 줄 인터페이스 - 언어 모델. 이 서버는 Hyprland의 창 관리, 레이아웃, 입력 등을 쿼리하고 제어하는 자연적인 언어 인터페이스를 가능하게 합니다. 이 프로젝트는 실험적이고 베타입니다. 예를 들어, Claude Desktop에서 ~/.config/Claude/claude desktop config.json 파일을 다음과 같이 수정합니다. 이 도구는 Hyprland의 기능과 상호 작용하는 언어 모델을 완벽하게 허용합니다. hyprctl activewindow -j을 실행하고 세부 사항을 반환합니다. 서버를 로컬로 실행하려면:

개요(AI 번역)

https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e] [T0]] [T0]] [T0]] [T0]] [T0]] [T0]] [T0]] [T0] [T0] [T0]] [T0] [T0] [T0]] [T0]] [T0] [T0] [T0] [T0] [T0]] [T0] [T0]] [T0] [T0] [T0]] [T0]] [T0] [T0] [T0]] https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e] https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e]]] https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e]]]]]] [[https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e]]]]]]] [[[[[[https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e]]]]]]]]]]]]]] [[[[[[[https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e]]]]]]]]]]]]]]]]]] [[[[[[[[[[[[[[[[[[[[[[

경량의, 비공식 모델 Context Protocol (MCP) 서버는 모든 기능을 노출시키는 hyprctl - Hyprland Wayland 작곡가의 명령행 인터페이스 - 언어 모델.

이 서버는 Hyprland의 창 관리, 레이아웃, 입력 등을 쿼리하고 제어하는 자연적인 언어 인터페이스를 가능하게 합니다.

주: 이 프로젝트는 실험적이고 베타입니다.

⭐ 빠른 시작

##1. 저장소를 복제

##2. HYPRLAND_INSTANCE_SIGNATURE 잡아

##3. MCP 클라이언트에서 서버를 설치

예를 들어, Claude Desktop에서, 다음과 같이 ~/.config/Claude/claude_desktop_config.json] 파일을 수정합니다.

사용 가능한 도구

도구 이름	Description
`run_hyprctl_command`	실행 임의 `hyprctl` 명령.
`get_version`	Hyprland 버전을 검색하고 정보를 작성합니다.
`list_monitors`	연결된 모든 모니터와 속성을 나열합니다.
`list_workspaces`	모든 Active Workspaces를 나열합니다.
[T9]	모든 창과 속성을 나열합니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e

A lightweight, unofficial Model Context Protocol (MCP) server that exposes all the functionality of hyprctl—the command-line interface for the Hyprland Wayland compositor—to language models.

This server enables natural language interfaces to query and control Hyprland’s window management, layouts, inputs, and more.

Note: This project is experimental and in beta.

🚀 Quick Start

1. Clone the repository

git clone https://github.com/stefanoamorelli/hyprmcp.git
cd hyprmcp

2. Grab your `HYPRLAND_INSTANCE_SIGNATURE`

echo $HYPRLAND_INSTANCE_SIGNATURE

3. Install the server in your MCP client

For example, in Claude Desktop, modify the ~/.config/Claude/claude_desktop_config.json file as follows:

"Hyperland MCP Server": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp[cli]",
    "--with",
    "subprocess",
    "mcp",
    "run",
   "/hyprmcp/hyprmcp/server.py"
  ],
  "env": {
    "PYTHONPATH": "/hyprmcp",
    "HYPRLAND_INSTANCE_SIGNATURE": ""
  }
},

🧰 Available Tools

Tool Name	Description
`run_hyprctl_command`	Executes arbitrary `hyprctl` commands.
`get_version`	Retrieves the Hyprland version and build info.
`list_monitors`	Lists all connected monitors and properties.
`list_workspaces`	Lists all active workspaces.
`list_clients`	Lists all windows and their properties.
`list_devices`	Lists all connected input devices.
`get_active_window`	Shows the currently active window details.
`list_layers`	Displays all layers in the compositor.
`get_splash`	Retrieves the current random splash message.
`dispatch_command`	Dispatches a command to Hyprland.
`set_keyword`	Dynamically sets a configuration keyword.
`reload_config`	Forces a reload of the Hyprland config file.
`enter_kill_mode`	Enables kill mode to terminate windows by click.

These tools allow language models to interact with Hyprland’s features seamlessly.

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

stefanoamorelli/hyprmcp

개요