Quick Start
2025.04.28
0
Python窗口管理输入控制工作区管理开发效率
Hyprland MCP Server 是一个轻量级的非官方 Model Context Protocol (MCP) 服务器，旨在通过自然语言接口暴露 Hyprland Wayland 合成器的所有功能。它允许语言模型查询和控制 Hyprland 的窗口管理、布局、输入等功能。该项目目前处于实验性和测试阶段。
View on GitHub
Overview
基本能力
产品定位
Hyprland MCP Server 是一个为 Hyprland Wayland 合成器提供自然语言接口的 MCP 服务器，使语言模型能够通过自然语言命令控制和管理 Hyprland 的窗口和输入设备。
核心功能
- 执行任意
hyprctl命令 - 获取 Hyprland 版本和构建信息
- 列出所有连接的显示器和属性
- 列出所有活动的工作区
- 列出所有窗口及其属性
- 列出所有连接的输入设备
- 获取当前活动窗口的详细信息
- 显示合成器中的所有层
- 获取当前的随机启动消息
- 向 Hyprland 发送命令
- 动态设置配置关键字
- 强制重新加载 Hyprland 配置文件
- 启用点击终止窗口的 kill 模式
适用场景
- 通过自然语言命令控制 Hyprland 窗口管理
- 查询 Hyprland 的当前状态和配置
- 自动化 Hyprland 的窗口和工作区管理
工具列表
| 工具名称 | 描述 |
|---|---|
run_hyprctl_command |
执行任意 hyprctl 命令 |
get_version |
获取 Hyprland 版本和构建信息 |
list_monitors |
列出所有连接的显示器和属性 |
list_workspaces |
列出所有活动的工作区 |
list_clients |
列出所有窗口及其属性 |
list_devices |
列出所有连接的输入设备 |
get_active_window |
获取当前活动窗口的详细信息 |
list_layers |
显示合成器中的所有层 |
get_splash |
获取当前的随机启动消息 |
dispatch_command |
向 Hyprland 发送命令 |
set_keyword |
动态设置配置关键字 |
reload_config |
强制重新加载 Hyprland 配置文件 |
enter_kill_mode |
启用点击终止窗口的 kill 模式 |
常见问题解答
- 项目目前处于实验性和测试阶段
- 需要 Hyprland 正在运行并设置必要的环境变量
使用教程
使用依赖
- Python 3.10+
- Linux 平台
- Hyprland 正在运行
安装教程
- 克隆仓库
git clone https://github.com/stefanoamorelli/hyprmcp.git
cd hyprmcp
- 获取
HYPRLAND_INSTANCE_SIGNATURE
echo $HYPRLAND_INSTANCE_SIGNATURE
- 在 MCP 客户端中安装服务器（以 Claude Desktop 为例）
修改
~/.config/Claude/claude_desktop_config.json文件
调试方式
mcp dev server.py
确保 Hyprland 正在运行并设置了必要的环境变量。