Hyprmcp MCP 服务器集成

“Hyprmcp” MCP 服务器有什么作用？

Hyprmcp 是一个轻量级、非官方的模型上下文协议（MCP）服务器，将 Hyprland Wayland 组合器的命令行接口 hyprctl 的全部功能暴露给语言模型。通过集成 Hyprmcp，AI 助手可用自然语言查询和控制 Hyprland 的窗口管理、布局、输入等功能。这让开发者和用户可以通过对话式 AI 接口完成获取工作区信息、管理显示器、运行任意 Hyprland 命令、获取系统状态等任务。该服务器为实验性和测试版，旨在为 Hyprland 丰富的命令集和现代语言模型驱动接口之间架起桥梁。

提示模板列表

在可用文档或仓库文件中未提及提示模板。

资源列表

仓库或 README 中未记录明确的 MCP 资源。

工具列表

• run_hyprctl_command
  执行任意 hyprctl 命令。
• get_version
  获取 Hyprland 版本及构建信息。
• list_monitors
  列出所有已连接的显示器及其属性。
• list_workspaces
  列出所有活动工作区。
• list_clients
  （未提供描述，但可能用于列出 Hyprland 客户端/窗口。）

本 MCP 服务器的用例

• 通过 AI 进行窗口管理
  让 AI 助手控制和查询 Hyprland 窗口、布局与工作区，简化桌面组织任务。
• 自动化系统状态查询
  开发者可用自然语言检查显示器配置、活动工作区和客户端窗口，辅助诊断与脚本化。
• 版本和环境审计
  通过 AI 查询获取 Hyprland 版本/构建信息，便于故障排查或文档编写。
• 与开发工具集成
  无缝将 Hyprland 控制集成到 MCP 兼容客户端（如 Claude、Cursor）中，实现开发者自动化。
• 自定义工作流自动化
  通过对话界面执行任意 hyprctl 命令，实现高级、可复用的设置和工作流。

如何配置

Windsurf

未提供 Windsurf 的配置指引或示例。

Claude

1. 克隆仓库
   • git clone https://github.com/stefanoamorelli/hyprmcp.git
   • cd hyprmcp
2. 获取 HYPRLAND_INSTANCE_SIGNATURE
   • echo $HYPRLAND_INSTANCE_SIGNATURE
3. 编辑配置文件
   • 打开 ~/.config/Claude/claude_desktop_config.json
4. 添加 Hyprmcp MCP 服务器
   • 插入如下 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>"
       }
     }
     

5. 保存并重启
   • 保存文件并重启 Claude Desktop 以应用更改。

密钥安全

在 env 部分使用环境变量：

"env": {
  "HYPRLAND_INSTANCE_SIGNATURE": "<your-hyprland-instance-signature>"
}

Cursor

未提供 Cursor 的配置指引或示例。

Cline

未提供 Cline 的配置指引或示例。

如何在流程中使用该 MCP

在 FlowHunt 中使用 MCP

要将 MCP 服务器集成到 FlowHunt 工作流中，请首先将 MCP 组件添加到流程，并将其连接到你的 AI 代理：

点击 MCP 组件以打开配置面板。在系统 MCP 配置部分，使用如下 JSON 格式填写你的 MCP 服务器信息：

{
  "hyprmcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置好后，AI 代理便可作为工具访问该 MCP 的全部功能。记得将 “hyprmcp” 替换为你的 MCP 服务器实际名称，并将 URL 替换为你自己的服务器地址。

总览

我们的看法

Hyprmcp 为 Hyprland 和 MCP 客户端之间提供了专注且实用的桥梁，在至少一个主流平台上有清晰的工具和配置。但它缺乏提示模板、明确的资源定义以及更广泛的配置/平台支持。作为实验项目，它为高级用户和开发者提供了良好起点，但如果能扩展文档与资源支持会更好。

MCP 评分

评分：5/10
基础功能（工具、许可证、核心功能）扎实，但在提示/资源文档和多平台配置细节上不足。