Homebridge

Name: Homebridge
Author: mp-consulting

von mp-consultingVersion 3.1.3i★ –iLäuft auf deinem Computer

Name in der Registryio.github.mp-consulting/homebridge-ai-kit

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Control Homebridge accessories and scenes, manage plugins and config.json, and read logs

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Entwicklertools
Das musst du eintragen: HOMEBRIDGE_URL, HOMEBRIDGE_TOKEN, HOMEBRIDGE_PASSWORD

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: HOMEBRIDGE_URL, HOMEBRIDGE_TOKEN, HOMEBRIDGE_USERNAME, HOMEBRIDGE_PASSWORD, HOMEBRIDGE_READ_ONLY

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Die .mcpb-Datei des Entwicklers herunterladen

Der Link führt zur Datei des Entwicklers selbst; wir hosten sie nicht und verpacken sie nicht neu. Öffne die Datei, dann installiert Claude Desktop sie.

Führe das in deinem Terminal aus

claude mcp add homebridge-ai-kit --env HOMEBRIDGE_URL=your-value --env HOMEBRIDGE_TOKEN=your-value --env HOMEBRIDGE_USERNAME=your-value --env HOMEBRIDGE_PASSWORD=your-value --env HOMEBRIDGE_READ_ONLY=your-value -- npx -y @mp-consulting/homebridge-ai-kit mcp

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "homebridge-ai-kit": {
      "command": "npx",
      "args": [
        "-y",
        "@mp-consulting/homebridge-ai-kit",
        "mcp"
      ],
      "env": {
        "HOMEBRIDGE_URL": "your-value",
        "HOMEBRIDGE_TOKEN": "your-value",
        "HOMEBRIDGE_USERNAME": "your-value",
        "HOMEBRIDGE_PASSWORD": "your-value",
        "HOMEBRIDGE_READ_ONLY": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "homebridge-ai-kit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mp-consulting/homebridge-ai-kit",
        "mcp"
      ],
      "env": {
        "HOMEBRIDGE_URL": "your-value",
        "HOMEBRIDGE_TOKEN": "your-value",
        "HOMEBRIDGE_USERNAME": "your-value",
        "HOMEBRIDGE_PASSWORD": "your-value",
        "HOMEBRIDGE_READ_ONLY": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

HOMEBRIDGE_URL erforderlich env
Homebridge UI URL, e.g. http://192.168.1.100:8581
HOMEBRIDGE_TOKEN geheim env
Homebridge UI API token (Glass UI, hbg_…); replaces username and password
HOMEBRIDGE_USERNAME env
Homebridge UI username, when no token is set
HOMEBRIDGE_PASSWORD geheim env
Homebridge UI password, when no token is set
HOMEBRIDGE_READ_ONLY env
true registers only read-only tools

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 8. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto mp-consulting bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Entwicklertoolsi

Mehr Sterne als 0 % der anderen 4924 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 70 % der anderen 4924 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 4924 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Homebridge sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: HOMEBRIDGE_URL, HOMEBRIDGE_TOKEN, HOMEBRIDGE_PASSWORD

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (3.1.3) kam vor 16 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js, MCPB auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: GitHub, Desktop Commander, Cloudflare MCP

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

GitHub

von github

Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

Computer oder Cloud★ 34.245MITAktualisiert vor 5 Tagen

Installieren

Desktop Commander

von wonderwhy-er

MCP server for terminal commands, file operations, and process management

Läuft auf deinem Computer★ 10.225MITAktualisiert vor 17 Tagen

Installieren

Cloudflare MCP

von cloudflare

Cloudflare MCP servers

Läuft in der Cloud★ 4.446Apache-2.0Aktualisiert vor 14 Monaten

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

@mp-consulting/homebridge-ai-kit

AI toolkit for Homebridge, in one package:

An MCP server that lets AI assistants (Claude Desktop, Claude Code, Cursor) control accessories, manage plugins, edit configuration and read logs, over stdio or Streamable HTTP.
The Assistant: provider adapters (Claude, OpenAI, Gemini, any OpenAI-compatible server), an agent loop wired to the MCP tools, and ready-made features (log doctor, config copilot, device-error explainer, update-risk briefing, organiser, daily digest). Homebridge Glass UI and the MP Consulting plugins use these.
A Homebridge plugin (HomebridgeAiKit platform) with a settings page to pick the provider and model, test the connection, serve MCP over HTTP and generate client configs.

The AI building blocks that don't need MCP also ship on their own as @mp-consulting/homebridge-ai-core — see Packages.

Renamed from `@mp-consulting/homebridge-mcp-server`. The old homebridge-mcp-server command still works, so existing MCP client configs don't need to change. See Migrating from homebridge-mcp-server.

Packages
Features
Providers
Homebridge plugin · MCP tokens
MCP server
Library API
Security
Migrating from homebridge-mcp-server
Development

Packages

This repository is an npm workspace that publishes two packages, both at version 2.0.0:

Package	Use it for	Runtime dependencies
`@mp-consulting/homebridge-ai-core`	Homebridge plugins. The plugin-UI Assistant routes (`registerAiRoutes` from `./plugin`), providers, redaction, prompts, config and the Assistant features (everything except `runAgent`).	`ajv` only
`@mp-consulting/homebridge-ai-kit` (this package)	Homebridge Glass UI and MCP. Everything in ai-core (re-exported) plus the MCP server, `runAgent`, the `HomebridgeAiKit` Homebridge plugin and `mcpClientSnippets`.	ai-core, `@modelcontextprotocol/sdk`, `socket.io-client`, `zod`, `undici`, `@homebridge/plugin-ui-utils`

Plugins should depend on ai-core, so installing them doesn't pull in the MCP SDK, socket.io or zod. ai-kit stays backward compatible: its . and ./plugin exports re-export everything ai-core has under the same names, so code that imports from ai-kit keeps working.

Features

MCP tools (43): accessories (list, get, control with value checks, bulk control with dryRun, locks / garage doors / alarms behind confirmation, room layout, sensor history), scenes (list, run, save), server (status, restart, pairing, cached accessories), child bridges (list, health, restart, stop, start), config (read with secrets redacted, full write, partial patch_config, dryRun diffs, backups and restore), instance backups, test notifications, plugins (list, search, versions, schema, changelog, install, update, uninstall), system info and logs (recent lines, filtered regex search).

MCP resources you can subscribe to: homebridge://accessories, homebridge://logs/recent, homebridge://status. Changes arrive over the Homebridge UI's socket.io namespaces, or by polling when the socket can't be used.

MCP resource templates (listed in resources/list, with completion): homebridge://accessory/{uniqueId} (one accessory with every characteristic), homebridge://plugin/{name} (one installed plugin and its child bridges; URL-encode scoped names), homebridge://child-bridge/{id} (one child bridge by username, with its health on Glass UI).

MCP prompts: diagnose-logs, plan-upgrade, audit-config, troubleshoot-device (device, symptom?), nightly-health-check (hours?), scene-builder (description, room?).

Assistant features (library): diagnoseLogs, generatePluginConfig, explainDeviceError, assessPluginUpdate, suggestOrganization, dailyDigest, ask, and runAgent for anything that needs the tools. Every input is redacted before it reaches a provider and trimmed to fit its context window; JSON outputs are checked against a schema with one automatic repair attempt; token usage and Claude costs are tracked.

Providers

All providers use plain fetch (no SDKs). Each declares what it can do, and features without tool calling fall back to prompt-only answers.

`provider`	Default model	API key	Tools	Streaming	Context
`anthropic`	`claude-sonnet-5-5`	required	yes	yes	1M (200K for Haiku)
`openai`	`gpt-6.1-sol`	required	yes	yes	128K (set `contextTokens` for more)
`gemini`	`gemini-3.8-flash`	required	yes	yes	1M
`openai-compatible`	`llama3.1`	optional	yes	yes	8K (set `contextTokens`)

Claude models: claude-sonnet-5-5 (default), claude-haiku-4-5-20251001 (cheapest), claude-opus-5-5 (most capable).
OpenAI models: gpt-6.1-sol (default), gpt-6-luna (cheapest), gpt-6-astra (most capable). Requests use the Responses API with store: false (nothing is kept on OpenAI's side); newer models only call tools through it. Set "openaiApi": "chat" to use Chat Completions instead, e.g. for a proxy that only speaks it.
openai-compatible works with Ollama (http://127.0.0.1:11434/v1, the default), LM Studio (http://127.0.0.1:1234/v1), vLLM and similar. Set contextTokens to your model's context window so inputs are trimmed correctly.
An on-device Apple Foundation Models provider is planned.

Homebridge plugin

Install it like any plugin (Homebridge 1.8+ or 2.x):

npm install -g @mp-consulting/homebridge-ai-kit

Then open its settings in the Homebridge UI. The settings page edits the HomebridgeAiKit platform block, tests the connection with the values in the form, and shows ready-to-paste configs for Claude Desktop, Claude Code and Cursor.

"platform": "HomebridgeAiKit", "name": "AI Kit", "enabled": true, "provider": "anthropic", // anthropic | openai | gemini | openai-compatible "model": "claude-sonnet-5-5", // optional, defaults per provider "apiKey": "sk-ant-…", // secret, redacted wherever config is shown to a model "baseUrl": "http://127.0.0.1:11434/v1", // openai-compatible only (or a proxy) "contextTokens": 32768, // optional override, mainly for local models "maxOutputTokens": 2048, "effort": "medium", // Claude and OpenAI: low | medium | high | xhigh | max (unset = model default) "openaiApi": "responses", // openai / openai-compatible: responses | chat (default responses for OpenAI, chat for local servers) "maxRetries": 2, // retries on 408/429/5xx/529 and network errors (backoff, honours retry-after); 0 = off "mcp": { "http": { "enabled": false, "host": "127.0.0.1", "port": 8582, "token": "…", // bearer token MCP clients must send "homebridgeUrl": "http://127.0.0.1:8581", "homebridgeToken": "hbg_…", // Glass UI API token the tools act with "homebridgeTokenId": "…", // written by Glass UI so it can revoke that token; leave as is "homebridgeCertFingerprint": "AB:CD:…", // https UI with a self-signed certificate: its SHA-256 fingerprint "homebridgeCertPath": "/path/to/certificate.pem", // or a PEM with the UI's certificate or its CA "readOnly": false, // true caps every client token at read-only "clients": [ // more client tokens, each with a scope: read | control | admin { "name": "Dashboard", "token": "…", "scope": "read" } ], "allowedOrigins": ["https://my-dashboard.local"], // browser pages allowed besides localhost / this server's IP "auditLog": true, // log every write tool call (JSONL) "auditLogPath": "/var/lib/homebridge/homebridge-ai-kit-audit.jsonl" // default: Homebridge storage path } } }

With mcp.http.enabled, the plugin serves MCP at http:// : /mcp while Homebridge runs. It needs a client token (mcp.http.token, HOMEBRIDGE_AI_MCP_TOKEN, or at least one scoped token in mcp.http.clients) and Homebridge credentials: a Glass UI API token in homebridgeToken, or the HOMEBRIDGE_* environment variables. A read-only API token gives clients read-only access.

MCP tokens

The MCP server uses two different tokens:

Token	What it is for	Stored in
Client token	What Claude, Cursor or another MCP client must send (`Authorization: Bearer …`) to reach the HTTP MCP server. Full access (`admin`), or read-only with `mcp.http.readOnly`	`mcp.http.token` (or `HOMEBRIDGE_AI_MCP_TOKEN` for the CLI)
Scoped client tokens	Optional extra client tokens with less access, e.g. a read-only token for a dashboard	`mcp.http.clients` (or `HOMEBRIDGE_AI_MCP_TOKENS` for the CLI)
Homebridge API token	What the MCP server sends to the Homebridge UI to run its tools. Its scope decides what clients can do: `read` gives read-only tools, `admin` gives all of them	`mcp.http.homebridgeToken` (or `HOMEBRIDGE_TOKEN` for the CLI)

Where to set or generate them:

Homebridge Glass UI 2.0.0-beta.6 or later: *Settings → Assistant → MCP server* generates the client token, creates the Homebridge API token in one click (read-only or admin, revoked again when you replace or remove it), and shows the client configs. Each secret is shown once; after that the page only says whether one is set.
This plugin's settings page: *Generate* creates a client token. Paste a Homebridge API token created in Glass UI under *Users → API Tokens*.
The CLI: set HOMEBRIDGE_AI_MCP_TOKEN and HOMEBRIDGE_TOKEN (see MCP server), e.g. HOMEBRIDGE_AI_MCP_TOKEN=$(openssl rand -base64 24).

Client token scopes (each includes the ones before it):

Scope	Tools
`read`	Every read-only tool
`control`	Plus device control: `set_accessory`, `set_security_accessory` (locks still need the user's confirmation), `set_accessories`, `run_scene`
`admin`	Plus everything else: config writes and restores, backups, `save_scene`, test notifications, plugin installs and updates, restarts, cached accessories, child bridges

The main client token is admin (as before), or read when readOnly is on; readOnly caps the scoped tokens too. A session belongs to the token that opened it. The client token decides which tools a client sees; the Homebridge API token still limits what the server itself can do, so a read API token keeps everything read-only.

Every write tool call is appended to an audit log ( /homebridge-ai-kit-audit.jsonl by default; mcp.http.auditLog / auditLogPath, or HOMEBRIDGE_AI_AUDIT_LOG for the CLI): one JSON object per line with ts, tool, args (secrets redacted), ok, error, session, client, principal (the token's name: default for the main token, agent for runAgent) and scope; notConfirmed: true marks a destructive call the user declined (MCP elicitation, or runAgent's confirm), which did not run. Dry runs are logged too, with dryRun: true in args. runAgent takes the same audit option. It rotates at 5 MB and keeps three old files.

Glass UI also stores homebridgeTokenId, the id of the API token it created, so it can revoke the token when you replace or remove it. The settings page keeps it (and any other field it doesn't show) when it saves.

Homebridge UI over HTTPS with a self-signed certificate

Node refuses a self-signed certificate, so the MCP server can't reach a Homebridge UI served that way until you tell it which certificate to trust. Verification is never turned off: the setting only appli

Nur der Anfang wird gezeigt; den Rest findest du im Repo

Homebridge

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Entwicklertoolsi

Häufige Fragen

Alternativen

GitHub

Desktop Commander

Cloudflare MCP

README vom Entwickler

@mp-consulting/homebridge-ai-kit

Contents

Packages

Features

Providers

Homebridge plugin

MCP tokens

Homebridge UI over HTTPS with a self-signed certificate