Fibaro Home Center 2 MCP Server (TypeScript)

TypeScript/Node.js implementasjon av Model Context Protocol (MCP) server for Fibaro Home Center 2.

Funksjoner

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

Installasjon

1. Installer avhengigheter

cd typescript
npm install

2. Konfigurer miljøvariabler

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

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

3. Bygg prosjektet

npm run build

Bruk

Kjør serveren lokalt

npm start

Bruk med Claude Desktop

Legg til i ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "fibaro-home-center": {
      "command": "node",
      "args": ["/full/path/to/fibaro-mcp/typescript/dist/index.js"],
      "env": {
        "FIBARO_URL": "http://192.168.1.100",
        "FIBARO_USERNAME": "admin",
        "FIBARO_PASSWORD": "your_password"
      }
    }
  }
}

Bruk med VS Code

Legg til i ~/.vscode/mcp.json:

{
  "mcpServers": {
    "fibaro-home-center": {
      "command": "node",
      "args": ["/full/path/to/fibaro-mcp/typescript/dist/index.js"],
      "env": {
        "FIBARO_URL": "http://192.168.1.100",
        "FIBARO_USERNAME": "admin",
        "FIBARO_PASSWORD": "your_password",
        "OLLAMA_URL": "http://localhost:11434"
      }
    }
  }
}

Bruk via npx (etter publisering til npm)

{
  "mcpServers": {
    "fibaro-home-center": {
      "command": "npx",
      "args": ["-y", "fibaro-mcp-server"],
      "env": {
        "FIBARO_URL": "http://192.168.1.100",
        "FIBARO_USERNAME": "admin",
        "FIBARO_PASSWORD": "your_password",
        "OLLAMA_URL": "http://localhost:11434"
      }
    }
  }
}

Konfigurasjon

Miljøvariabler

| Variabel | Beskrivelse | Påkrevd | Default | |----------|-------------|---------|---------| | FIBARO_URL | URL til Fibaro HC2 (f.eks. http://192.168.1.100) | Ja | - | | FIBARO_USERNAME | Brukernavn | Ja | - | | FIBARO_PASSWORD | Passord | Ja | - | | FIBARO_USE_HTTPS | Bruk HTTPS (true/false) | Nei | false | | OLLAMA_URL | URL til lokal Ollama instans | Nei | http://localhost:11434 | | HOME_STATUS_CAMERA_CONCURRENCY | Antall samtidige kamera-analyser | Nei | 2 | | HOME_STATUS_CAMERA_INCLUDE | Liste av kamera-IDer som skal analyseres | Nei | (Alle) | | HOME_STATUS_CAMERA_EXCLUDE | Liste av kamera-IDer som skal ekskluderes | Nei | (Ingen) | | HOME_STATUS_TEST_TIMEOUT | Timeout for kamera-analyse (ms) | Nei | 30000 | "FIBARO_PASSWORD": "your_password" } } } }

## 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.)

### Rom (Rooms)
- `list_rooms` - List alle rom i systemet
- `get_room` - Hent informasjon om et spesifikt rom
- `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

### Globale Variabler
- `list_global_variables` - List alle globale variabler
- `get_global_variable` - Hent en spesifikk global variabel
- `set_global_variable` - Sett en global variabel

## Utvikling

### Watch mode (auto-rebuild ved endringer)

```bash
npm run dev

Kjør direkte uten bygging

npm install -g tsx
tsx src/index.ts

Fordeler med TypeScript-versjonen

• ✅ Ingen pip-installasjon - Kun npm install
• ✅ Type safety - Full TypeScript type checking
• ✅ Enklere distribusjon - Kan publiseres til npm
• ✅ npx support - Kan kjøres direkte uten installasjon
• ✅ Bedre ytelse - Kompilert JavaScript
• ✅ Moderne async/await - Enklere å lese og vedlikeholde

Sammenligning med Python-versjonen

Begge versjoner har identisk funksjonalitet:

| Funksjon | Python | TypeScript | |----------|--------|------------| | Device control | ✅ | ✅ | | Room management | ✅ | ✅ | | Scene management | ✅ | ✅ | | LUA code display | ✅ | ✅ | | Global variables | ✅ | ✅ | | System info | ✅ | ✅ |

Velg TypeScript hvis:

• Du foretrekker Node.js økosystemet
• Du vil distribuere via npm
• Du vil bruke npx for enkel installasjon

Velg Python hvis:

• Du allerede har Python installert
• Du foretrekker Python syntaks
• Du har andre Python-avhengigheter

Lisens

MIT