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>"
  }
},

✨ 主な機能

💻 使用例

基本的な使用法

# ディスプレイ情報を照会する
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 リポジトリ
• ライセンス