広告掲載
MCP.so
ログイン

Hyprland MCP Server

@stefanoamorelli

リポジトリ

基本情報

カテゴリ

その他

ライセンス

MIT license

トランスポート

stdio

作者

stefanoamorelli

Hyprland MCP Server について

Community MCP server for hyprctl

Hyprland MCP Server の設定

標準の設定はありません

このサーバーの README には解析可能な MCP 設定ブロックが含まれていません。インストール手順はリポジトリをご確認ください。

リポジトリ

Hyprland MCP Server のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Hyprland MCP Server?

Hyprland MCP Server is a lightweight, unofficial Model Context Protocol (MCP) server that exposes the full functionality of hyprctl—the command-line interface for the Hyprland Wayland compositor—to language models. It enables natural language interfaces to query and control Hyprland’s window management, layouts, inputs, and more.

How to use Hyprland MCP Server?

Clone the repository, obtain your HYPRLAND_INSTANCE_SIGNATURE environment variable, then configure the server in your MCP client (e.g., Claude Desktop) by editing ~/.config/Claude/claude_desktop_config.json with the uv run command and required environment variables. For development, run mcp dev server.py locally while Hyprland is running.

Key features of Hyprland MCP Server

  • Executes arbitrary hyprctl commands via run_hyprctl_command.
  • Retrieves Hyprland version, monitors, workspaces, clients, and devices.
  • Shows active window details and compositor layers.
  • Dispatches commands to Hyprland for window/workspace control.
  • Dynamically sets configuration keywords with set_keyword.
  • Reloads the Hyprland config file and enters kill mode.

Use cases of Hyprland MCP Server

  • Switch to a specific workspace or move windows using natural language.
  • Query details of the currently active window or all connected monitors.
  • List all open windows and their properties for inventory or automation.
  • Dispatch Hyprland commands (e.g., toggle floating, change layout) via chat.
  • Dynamically adjust Hyprland settings like gaps, borders, or input behavior.

よくある質問

1

Is Hyprland MCP Server an official Hyprland tool?

No, it is an unofficial, community-maintained server and is currently in beta.

2

What are the runtime requirements?

Python 3.10+ and the `uv` package manager are required. The server runs only on Linux with Hyprland active, and the `HYPRLAND_INSTANCE_SIGNATURE` environment variable must be set.

3

How does the server communicate with Hyprland?

It invokes `hyprctl` commands (with optional JSON output) via subprocess, using the instance signature for authentication. No separate authentication step is needed.

4

What transports does the server use?

It uses the standard MCP protocol transport (stdio) as defined in the MCP specification. No custom transports are supported.

5

Are there any known limitations?

This is an experimental beta release; reliability and full coverage of all `hyprctl` features are not guaranteed. The server must run on the same machine as the Hyprland session.

コメント

「その他」の他のコンテンツ

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K
広告掲載