stefanoamorelli/hyprmcp

[[Т0]]

Легкий неофициальный сервер Model Context Protocol (MCP), который раскрывает все функциональные возможности T1 — интерфейса командной строки для композита Hyprland Wayland — для языковых моделей.

Этот сервер позволяет интерфейсам естественного языка запрашивать и контролировать управление окнами Hyprland, макеты, входы и многое другое.

**Примечание: ** Проект экспериментальный и находится в стадии бета-тестирования.

Быстрый старт

###1.Клонировать репозиторий

###2.Возьми свой HYPRLAND_INSTANCE_SIGNATURE

###3 Установите сервер в MCP-клиенте

Например, в Claude Desktop изменить файл ~/.config/Claude/claude_desktop_config.json следующим образом:

Доступные инструменты

Название инструмента | Описание

run_hyprctl_command[T5]]hyprctl[[T]][T5]][[T]][T][T]][T][T]][T][T]][T][T]][T][T]][T][T]][T][T][T]][T][T]][T][T]][T][T]][T][T][T]][T][T]][T][T]][T][T][T]][T][T]][T][T]][T][T][T]][T][T][T]][T][T]][T][T][T]][T][T]][T][T][T]][T][T]][T][T][T]][T][T]][T][T][T]][T][T][T]][T][T [6][править править вики-текст][править править код] list_monitors | Список всех подключенных мониторов и свойств. list_workspaces | Список всех активных рабочих пространств. [9][9]] Все окна и их свойства

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

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