stefanoamorelli/hyprmcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

35 stars 7 forks 品質 53 トレンド 12MIT

Repository Install

Hyprctl コミュニティ MCP サーバー

概要

[https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e] hyprctlの全ての機能を公開する、軽量で非公式なモデルコンテキストプロトコル(MCP)サーバー(Hyprland Wayland compositorのコマンドラインインターフェイス)を言語モデルに表示します。このサーバーは、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]

[hyprctlのすべての機能を公開する、軽量で非公式なモデルコンテキストプロトコル(MCP)サーバーは、Hyprland Wayland compositor のコマンドラインインターフェイスで、言語モデルへ。

このサーバーは、Hyprlandのウィンドウ管理、レイアウト、インプットなどを照会および制御するために自然な言語インターフェイスを可能にします。

注記: このプロジェクトは実験的、ベータ版です。

すぐにスタート

##1. リポジトリのクローン化

##2. [[T2]をつかむ

##3. MCP クライアントにサーバーをインストールする

たとえば、Claude Desktop では、~/.config/Claude/claude_desktop_config.json] ファイルを以下のように変更します。

利用可能なツール

会社概要
[`run_hyprctl_command`
[`get_version`
【`list_monitors`
[[T8]
[`list_clients`

このページは 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 のガイドから始めましょう →