Hyprmcp MCP Sunucusu Entegrasyonu

“Hyprmcp” MCP Sunucusu ne işe yarar?

Hyprmcp, dil modellerine Hyprland Wayland kompozitörü için komut satırı arayüzü olan hyprctl‘nin tüm işlevselliğini açan hafif, resmi olmayan bir Model Context Protocol (MCP) sunucusudur. Hyprmcp ile entegre edildiğinde, yapay zeka asistanları doğal dil kullanarak Hyprland’in pencere yönetimini, düzenlerini, girişlerini ve daha fazlasını sorgulayabilir ve kontrol edebilir. Bu, çalışma alanı bilgilerini alma, monitörleri yönetme, rastgele Hyprland komutları çalıştırma ve sistem durumunu elde etme gibi görevleri konuşmaya dayalı bir yapay zeka arayüzüyle mümkün kılarak geliştirici ve kullanıcı iş akışlarını kolaylaştırır. Sunucu deneysel ve beta aşamasında olacak şekilde tasarlanmıştır; Hyprland’in zengin komut seti ile modern dil modeli tabanlı arayüzler arasında bir köprü kurar.

Prompt Listesi

Mevcut belgelerde veya depo dosyalarında prompt şablonlarından bahsedilmemiştir.

Kaynak Listesi

Depoda veya README’de açık bir MCP kaynağı belgelenmemiştir.

Araç Listesi

• run_hyprctl_command
  Rastgele hyprctl komutlarını çalıştırır.
• get_version
  Hyprland sürüm ve derleme bilgisini alır.
• list_monitors
  Bağlı tüm monitörleri ve özelliklerini listeler.
• list_workspaces
  Aktif tüm çalışma alanlarını listeler.
• list_clients
  (Açıklama verilmemiştir, muhtemelen Hyprland istemcilerini/pencerelerini listeler.)

Bu MCP Sunucusunun Kullanım Senaryoları

• Yapay Zeka ile Pencere Yönetimi
  Yapay zeka asistanlarının Hyprland pencere, düzen ve çalışma alanlarını kontrol etmesini ve sorgulamasını sağlayarak masaüstü organizasyonunu kolaylaştırır.
• Otomatik Sistem Durumu Sorgulamaları
  Geliştiriciler monitör yapılandırmalarını, aktif çalışma alanlarını ve istemci pencerelerini doğal dil ile sorgulayabilir; tanılama ve betik yazımına yardımcı olur.
• Sürüm ve Ortam Denetimi
  Yapay zeka sorgularıyla Hyprland sürüm/derleme bilgisini tanılama veya belgeleme için alın.
• Geliştirici Araçları ile Entegrasyon
  Hyprland kontrolünü MCP uyumlu istemcilere (ör. Claude, Cursor) sorunsuz şekilde entegre edin.
• Özel İş Akışı Otomasyonu
  Konuşmaya dayalı arayüzlerden rastgele hyprctl komutları kullanarak gelişmiş ve tekrarlanabilir kurulumlar ve iş akışları oluşturun.

Kurulum nasıl yapılır

Windsurf

Windsurf için kurulum talimatı veya yapılandırma örneği sağlanmamıştır.

Claude

1. Depoyu Klonlayın
   • git clone https://github.com/stefanoamorelli/hyprmcp.git
   • cd hyprmcp
2. HYPRLAND_INSTANCE_SIGNATURE Anahtarınızı Alın
   • echo $HYPRLAND_INSTANCE_SIGNATURE
3. Yapılandırmayı Düzenleyin
   • ~/.config/Claude/claude_desktop_config.json dosyasını açın
4. Hyprmcp MCP Sunucusunu Ekleyin
   • Aşağıdaki JSON parçasını ekleyin:

     "Hyperland MCP Server": {
       "command": "uv",
       "args": [
         "run",
         "--with",
         "mcp[cli]",
         "--with",
         "subprocess",
         "mcp",
         "run",
         "<deponun global yolu>/hyprmcp/hyprmcp/server.py"
       ],
       "env": {
         "PYTHONPATH": "<deponun global yolu>/hyprmcp",
         "HYPRLAND_INSTANCE_SIGNATURE": "<hyprland-instance-signature'ınız>"
       }
     }
     

5. Kaydedin ve Yeniden Başlatın
   • Dosyayı kaydedin ve değişikliklerin geçerli olması için Claude Desktop’u yeniden başlatın.

API Anahtarlarını Güvenceye Alma

env bölümünde ortam değişkenlerini kullanın:

"env": {
  "HYPRLAND_INSTANCE_SIGNATURE": "<hyprland-instance-signature'ınız>"
}

Cursor

Cursor için kurulum talimatı veya yapılandırma örneği sağlanmamıştır.

Cline

Cline için kurulum talimatı veya yapılandırma örneği sağlanmamıştır.

Bu MCP’yi akışlarda nasıl kullanabilirim

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için, önce MCP bileşenini akışınıza ekleyin ve AI ajanınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırma bölümünde, MCP sunucu bilgilerinizi şu JSON formatında girin:

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

Yapılandırıldıktan sonra, AI ajanı bu MCP’yi bir araç olarak kullanabilecek ve tüm işlevlerine ve yeteneklerine erişebilecektir. “hyprmcp” adını kendi MCP sunucunuzun adıyla ve URL’yi kendi sunucu URL’inizle değiştirmeyi unutmayın.

Genel Bakış

Bizim görüşümüz

Hyprmcp, Hyprland ve MCP istemcileri arasında net araçlar ve en az bir ana platform için kurulumla odaklı ve faydalı bir köprü sunuyor. Ancak prompt şablonları, açık kaynak tanımları ve daha geniş kurulum/platform desteği eksik. Deneysel bir proje olarak, ileri düzey kullanıcılar ve geliştiriciler için sağlam bir başlangıç noktası; fakat daha geniş dokümantasyon ve kaynak desteğiyle güçlenebilir.

MCP Skoru

PUAN: 5/10
Temellerde (araçlar, lisans, ana işlev) sağlam, ancak prompt/kaynak dokümantasyonu ve çoklu platform kurulum detaylarında eksik.