Hyprmcp

🚀 Hyprland MCP 服務器

這是一個輕量級的、非官方的模型上下文協議 (MCP) 服務器，它將 hyprctl（Hyprland 的命令行界面——Hyprland Wayland 合成器的 CLI）的所有功能開放出來，讓語言模型可以查詢和控制 Hyprland 的窗口管理、佈局、輸入等功能。通過自然語言接口，用戶能夠方便地查詢並控制 Hyprland 的窗口管理、佈局、輸入等操作。

⚠️ 重要提示

該項目是實驗性的，目前處於測試階段。

🚀 快速開始

1. 克隆倉庫

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

2. 獲取你的 HYPRLAND_INSTANCE_SIGNATURE

echo $HYPRLAND_INSTANCE_SIGNATURE

3. 在 MCP 客戶端中安裝服務器

例如，在 Claude Desktop 中，修改 ~/.config/Claude/claude_desktop_config.json 文件如下：

"Hyperland MCP Server": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp[cli]",
    "--with",
    "subprocess",
    "mcp",
    "run",
   "<global path of the repo>/hyprmcp/hyprmcp/server.py"
  ],
  "env": {
    "PYTHONPATH": "<global path of the repo>/hyprmcp",
    "HYPRLAND_INSTANCE_SIGNATURE": "<your-hyprland-instance-signature>"
  }
},

✨ 主要特性

此服務器暴露了 hyprctl 的所有功能，提供了自然語言接口，允許查詢並控制 Hyprland 的窗口管理、佈局、輸入等。

🧰 可用工具

💻 使用示例

基礎用法

# 查詢顯示器信息
mcp run hyperland_mcp_server.list_monitors

# 查詢窗口信息
mcp run hyperland_mcp_server.get_active_window

# 查詢工作區信息
mcp run hyperland_mcp_server.list_workspaces

🛠️ 開發說明

# 運行服務器
python3 -m hyperland_mcp_server

📄 許可證

參考資料

• MCP 協議
• Hyprland 倉庫
• 許可證