Fibaro Home Center 2 MCP Server

En Model Context Protocol (MCP) server for integrasjon med Fibaro Home Center 2.

Bygget med TypeScript/Node.js for moderne npx-støtte og enkel installasjon.

🚀 Rask installasjon

Via VS Code (Ett klikk)

Klikk på knappen over for å installere direkte i VS Code - den enkleste måten!

Via npm

npm install -g fibaro-mcp-server
# eller kjør direkte med npx
npx fibaro-mcp-server

Funksjoner

• 📱 List og kontroller enheter (devices)
• 🏠 Administrer rom (rooms)
• 🎬 Trigger scener (scenes) med full LUA-kode visning
• 📊 Hent enhetsinformasjon og status
• 🔧 Oppdater enhetsparametere
• 🌍 Administrer globale variabler
• 🔍 Systemdiagnostikk (minne, lagring, CPU)
• 👥 Brukeradministrasjon
• 📂 Seksjonsadministrasjon
• ⚡ Energiforbruksovervåkning
• 🌡️ Temperaturdata
• 📍 Lokasjonsinformasjon
• 🎥 NYT: AI-drevet kameraanalyse med lokal Ollama (se CAMERA_ANALYSIS.md)

Prosjektstruktur

fibaro-mcp-server/
├── typescript/      # TypeScript-implementasjon (hoved-kode)
│   ├── src/         # TypeScript source
│   ├── dist/        # Compiled JavaScript
│   └── package.json
├── CAMERA_ANALYSIS.md  # AI kamera-analyse dokumentasjon
├── QUICKSTART.md      # 5-minutters oppsettguide
├── VSCODE_CONFIG.md   # VS Code MCP konfigurasjon
└── README.md          # Denne filen

Installasjon og Konfigurasjon

Se typescript/README.md for detaljert dokumentasjon.

Rask start:

cd typescript
npm install
npm run build
# Konfigurer i ~/.vscode/mcp.json (se VSCODE_CONFIG.md)

Kjør:

npm start

📖 Se full TypeScript dokumentasjon

Rask start

Ny bruker? → Les QUICKSTART.md for 5-minutters oppsett! 🚀

Via npm/npx

# Installer globalt
npm install -g fibaro-mcp-server

# Eller kjør direkte med npx (ingen installasjon nødvendig)
npx fibaro-mcp-server

Fra source

git clone https://github.com/rokris/fibaro-mcp-server.git
cd fibaro-mcp-server/typescript
npm install
npm run build

Konfigurering

All konfigurasjon skjer via ~/.vscode/mcp.json eller GitHub Copilot settings. Dette prosjektet bruker ikke .env-filer.

Se VSCODE_CONFIG.md for detaljert konfigurering av MCP-server i VS Code.

Bruk

Kjør serveren

# Via npx
npx fibaro-mcp-server

# Eller hvis installert globalt
fibaro-mcp-server

MCP Tools

Serveren tilbyr følgende tools:

Enheter (Devices)

• list_devices - List alle enheter i systemet
• get_device - Hent informasjon om en spesifikk enhet
• control_device - Kontroller en enhet (turn on/off, set value, etc.)
• get_device_properties - Hent egenskaper for en enhet

Rom (Rooms)

• list_rooms - List alle rom i systemet
• get_room_devices - Hent enheter i et spesifikt rom

Scener (Scenes)

• list_scenes - List alle scener
• get_scene - Hent detaljert informasjon om en scene (inkludert LUA-kode, triggers, actions)
• trigger_scene - Aktiver en scene

System

• get_system_info - Hent systeminformasjon
• get_weather - Hent værinformasjon
• get_home_status - Hent komplett statusrapport for hjemmet (inkludert AI-analyse av kameraer)

Globale Variabler

• list_global_variables - List alle globale variabler
• get_global_variable - Hent en spesifikk global variabel
• set_global_variable - Sett en global variabel

Fibaro Home Center 2 API

Serveren bruker Fibaro Home Center 2 REST API:

• Base URL: http(s)://<host>/api/
• Autentisering: HTTP Basic Auth
• Endpoints:
  • /api/devices - Enheter
  • /api/rooms - Rom
  • /api/scenes - Scener
  • /api/settings/info - Systeminformasjon

Utvikling

Installer dev-avhengigheter:

cd typescript
npm install

Bygg prosjektet:

npm run build

Kjør i watch-mode under utvikling:

npm run dev

Lisens

MIT