Home Assistant MCP Sunucusu

“Home Assistant” MCP Sunucusu ne yapar?

Home Assistant MCP Sunucusu (hass-mcp), AI asistanlarını—Claude ve diğer LLM’ler gibi—Home Assistant ekosisteminizle buluşturan bir Model Context Protocol (MCP) sunucusudur. Home Assistant’ın verilerini ve işlevselliğini MCP standardı üzerinden açığa çıkararak, AI ajanlarının akıllı ev cihazları ve otomasyonları ile etkileşime geçmesine, sorgulamasına ve kontrol etmesine olanak tanır. hass-mcp’nin etkinleştirdiği tipik görevler arasında cihaz ve sensör durumlarını sorgulama, ışık veya anahtarları açıp kapama, ev durumunu özetleme, otomasyon sorunlarını giderme, belirli varlıkları arama ve yaygın akıllı ev aktiviteleri için rehberli sohbetler oluşturma yer alır. Bu entegrasyon, akıllı ev yönetimini konuşma tabanlı AI, otomasyonlar ve LLM destekli ajanlar aracılığıyla erişilebilir kılarak geliştirici ve kullanıcı iş akışlarını geliştirir.

Komut Listesi

• Depoda belgelenmiş bir komut şablonu bulunamadı.

Kaynak Listesi

• Depoda açıkça listelenmiş MCP kaynağı bulunamadı.

Araçlar Listesi

• Cihazların ve sensörlerin durumunu sorgulama: LLM’lerin Home Assistant varlıklarının mevcut durumunu almasını sağlar.
• Işıkları, anahtarları ve diğer varlıkları kontrol etme: Desteklenen akıllı ev bileşenlerinde (aç/kapa, parlaklık, vb.) doğrudan kontrol imkanı tanır.
• Akıllı evinizin özetini alma: Evin mevcut durumu hakkında üst düzey özetler veya toplanmış bilgiler sağlar.
• Otomasyonlar ve varlıklar için sorun giderme: Otomasyonlar veya cihaz varlıklarındaki sorunların çözümü için tanılayıcı bilgiler ya da adımlar sunar.
• Belirli varlıkları arama: Kullanıcıların veya ajanların Home Assistant içinde isim veya tür ile cihaz/sensör bulmasını sağlar.
• Yaygın görevler için rehberli sohbetler oluşturma: Kullanıcıları sık karşılaşılan akıllı ev işlemlerinde adım adım yönlendiren yapılandırılmış etkileşimleri destekler.

Bu MCP Sunucusunun Kullanım Senaryoları

• Cihaz Durumu Sorgulama: Geliştiriciler ve kullanıcılar, mevcut durumları programlı veya sohbet yoluyla sorgulayarak (örn. “Mutfak penceresi açık mı?”), izleme ve otomasyon mantığı kurabilir.
• Akıllı Ev Kontrolü: Sesli asistanlar veya sohbet botları ile ışıkları açıp kapama, termostat ayarlama veya cihaz kontrolü; erişilebilirlik ve otomasyonun artırılması.
• Ev Durumu Raporları: LLM’ler, kullanıcı kolaylığı veya panolara entegrasyon için günlük ya da isteğe bağlı özet raporları (“Bu akşam evimin durumu nedir?” gibi) oluşturabilir.
• Otomasyon Sorun Giderme: Geliştiriciler, MCP sunucusu ile otomasyonlardaki yanlış yapılandırmaları veya hataları tespit edebilir, hata ayıklamayı kolaylaştırır.
• Varlık Arama & Rehberli Görev Akışları: Cihaz bulma veya kullanıcıyı çok adımlı rutinlerde yönlendirme (“Sabah rutini kur”) gibi işlemler akıllı ev yönetimini kolaylaştırır.

Nasıl Kurulur

Windsurf

1. Sisteminizde Python ve Docker’ın kurulu olduğundan emin olun.
2. hass-mcp deposunu klonlayın ve Home Assistant bağlantınızı bir .env dosyasında yapılandırın (bkz. .env.example).
3. Windsurf’te ayarlarınızın MCP Sunucuları bölümünü açın.
4. hass-mcp sunucusunu şu şekilde bir JSON yapılandırmasıyla ekleyin:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "docker",
         "args": ["run", "--env-file=.env", "-p", "8080:8080", "voska/hass-mcp:latest"]
       }
     }
   }
   

5. Ayarları kaydedin ve Windsurf’ü yeniden başlatın. Sunucunun MCP listesinde göründüğünü doğrulayın.

Claude

1. hass-mcp sunucusunu yerel olarak veya Claude tarafından erişilebilen bir sunucuya kurun.
2. Home Assistant API anahtarınızı ortam değişkenleri ile güvenli hale getirin.
3. Claude yapılandırmasında MCP sunucu girişini ekleyin:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Claude’u yeniden başlatın ve MCP sunucu erişimini kontrol edin.
5. Hassas verileri korumak için ortam değişkenleri kullanın (aşağıya bakınız).

Cursor

1. hass-mcp’yi dağıtın ve Cursor ile MCP sunucusu arasında ağ erişimi olduğundan emin olun.
2. Cursor’u MCP sunucusunu kullanacak şekilde yapılandırın:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

3. Yapılandırmayı kaydedin ve Cursor’u yeniden başlatın.
4. Gerekirse API anahtarları için ortam değişkenleri ayarlayın.

Cline

1. Bağımlılıkları yükleyin ve hass-mcp sunucusunu çalıştırın (ayrıntılar için depoya bakın).
2. Cline’da MCP yapılandırma dosyanızı açın.
3. hass-mcp sunucusunu ekleyin:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. Yeni MCP sunucusunu etkinleştirmek için Cline’ı yeniden başlatın.

API Anahtarlarını Güvenli Tutma (Tüm Platformlar):

Hassas bilgilerinizi korumak için yapılandırmanızda ortam değişkenleri kullanın:

{
  "mcpServers": {
    "hass-mcp": {
      "env": {
        "HASS_TOKEN": "${HASS_TOKEN}"
      },
      "inputs": {
        "hass_url": "http://your-homeassistant.local:8123"
      }
    }
  }
}

Bu MCP’yi akışlarda nasıl kullanırsınız

FlowHunt’ta MCP Kullanımı

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

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

{
  "hass-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırma tamamlandığında, AI ajanınız artık bu MCP’yi tüm işlev ve yeteneklerine erişebilen bir araç olarak kullanabilir. “hass-mcp” ismini kendi MCP sunucunuzun adıyla ve URL’yi de kendi MCP sunucu URL’nizle değiştirmeyi unutmayın.

Genel Bakış

Mevcut dokümantasyon ve depo içeriğine göre, hass-mcp MCP üzerinden Home Assistant entegrasyonu için sağlam bir temel sunar; net araç desteği ve makul kurulum/güvenlik uygulamalarıyla birlikte gelir. Ancak, açıkça tanımlanmış komut şablonları, kaynak tanımları veya gelişmiş örnekleme/kök özellikleri kamuya açık belgede yoktur. Bu MCP sunucusunu 6/10 olarak değerlendiriyorum: işlevsel ve geliştirici dostu, fakat genişletilebilirlik belgeleri ve gelişmiş MCP özellikleri açısından eksik.

MCP Puanı