claude-ha wieder in claude zusammenführen, falls der HA-MCP-Context-Verbrauch gelöst ist #3

Closed
opened 2026-11-05 19:44:43 +00:00 by mandlm · 1 comment
Owner

Hintergrund

Der Home-Assistant-MCP (ha-k3s, https://ha-mcp.molez.org/mcp) ist nicht global in ~/.claude.json registriert, sondern nur über den Wrapper claude-ha (llm/tools/claude-code.nix, --mcp-config ~/.claude/mcp-ha.json) ladbar.

Grund der Trennung: Das frühere Paar ha-k3s + ha-kube brachte 22 Tools mit ca. 65 KB Schema. Das waren gemessen 44 % des gesamten Tool-Schema-Gewichts in einer frischen Session.

Ziel

Prüfen, ob der Context-Verbrauch des HA-MCP inzwischen so niedrig ist, dass er wieder global registriert werden kann. Falls ja, entfällt claude-ha.

Zu prüfen

  • Aktuelle Anzahl der Tools und Größe des Schemas von ha-k3s (ein Server, nicht mehr zwei). Messen, z. B. mit /context in einer frischen Session mit und ohne claude-ha.
  • Hat sich ha-mcp upstream geändert (Tool-Filter, Tool-Gruppen, schlankere Schemas)? Releasenotes prüfen.
  • Gibt es auf Gateway- oder Server-Seite eine Möglichkeit, das Tool-Set auf das Nötige zu beschränken?
  • Tool Search / deferred Tools: Werden die HA-Tools in Claude Code inzwischen deferred geladen, sodass nur Namen im Context landen und die Schemas erst bei Bedarf geholt werden? Dann wäre der Verbrauch kein Problem mehr.

Akzeptanzkriterien

  • Messwert dokumentiert: Context-Verbrauch des HA-MCP in einer frischen Session (Tokens bzw. Anteil am Gesamtgewicht der Tool-Schemas).
  • Entscheidung getroffen, ob der Verbrauch akzeptabel ist (Schwelle vorher festlegen).
  • Falls akzeptabel:
    • ha-k3s global registrieren (Activation-Skript in llm/tools/claude-code.nix; der bisherige Block claudeCodeRemoveHomeAssistantMcp ist dann zu ersetzen).
    • claudeHaScript, home.packages-Eintrag und .claude/mcp-ha.json entfernen.
    • llm/auto-mode/personal.json anpassen (Hinweis, dass HA nur über claude-ha erreichbar ist, entfällt).
    • OAuth-Token in ~/.claude/.credentials.json (mcpOAuth) prüfen, ob er nach der Umstellung weiter greift.
    • nh home build . und Smoke-Test: HA-Tool in normaler claude-Session aufrufen.
  • Falls nicht akzeptabel: Ergebnis und Messwerte hier kommentieren, Issue schließen, claude-ha bleibt.
## Hintergrund Der Home-Assistant-MCP (`ha-k3s`, `https://ha-mcp.molez.org/mcp`) ist nicht global in `~/.claude.json` registriert, sondern nur über den Wrapper `claude-ha` (`llm/tools/claude-code.nix`, `--mcp-config ~/.claude/mcp-ha.json`) ladbar. Grund der Trennung: Das frühere Paar `ha-k3s` + `ha-kube` brachte 22 Tools mit ca. 65 KB Schema. Das waren gemessen 44 % des gesamten Tool-Schema-Gewichts in einer frischen Session. ## Ziel Prüfen, ob der Context-Verbrauch des HA-MCP inzwischen so niedrig ist, dass er wieder global registriert werden kann. Falls ja, entfällt `claude-ha`. ## Zu prüfen - Aktuelle Anzahl der Tools und Größe des Schemas von `ha-k3s` (ein Server, nicht mehr zwei). Messen, z. B. mit `/context` in einer frischen Session mit und ohne `claude-ha`. - Hat sich `ha-mcp` upstream geändert (Tool-Filter, Tool-Gruppen, schlankere Schemas)? Releasenotes prüfen. - Gibt es auf Gateway- oder Server-Seite eine Möglichkeit, das Tool-Set auf das Nötige zu beschränken? - Tool Search / deferred Tools: Werden die HA-Tools in Claude Code inzwischen deferred geladen, sodass nur Namen im Context landen und die Schemas erst bei Bedarf geholt werden? Dann wäre der Verbrauch kein Problem mehr. ## Akzeptanzkriterien - [ ] Messwert dokumentiert: Context-Verbrauch des HA-MCP in einer frischen Session (Tokens bzw. Anteil am Gesamtgewicht der Tool-Schemas). - [ ] Entscheidung getroffen, ob der Verbrauch akzeptabel ist (Schwelle vorher festlegen). - [ ] Falls akzeptabel: - `ha-k3s` global registrieren (Activation-Skript in `llm/tools/claude-code.nix`; der bisherige Block `claudeCodeRemoveHomeAssistantMcp` ist dann zu ersetzen). - `claudeHaScript`, `home.packages`-Eintrag und `.claude/mcp-ha.json` entfernen. - `llm/auto-mode/personal.json` anpassen (Hinweis, dass HA nur über `claude-ha` erreichbar ist, entfällt). - OAuth-Token in `~/.claude/.credentials.json` (`mcpOAuth`) prüfen, ob er nach der Umstellung weiter greift. - `nh home build .` und Smoke-Test: HA-Tool in normaler `claude`-Session aufrufen. - [ ] Falls nicht akzeptabel: Ergebnis und Messwerte hier kommentieren, Issue schließen, `claude-ha` bleibt.
Author
Owner

Messung (frische Session, Claude Code 2.1.312, /context all)

  • ha-k3s liefert jetzt 11 Tools (vorher ha-k3s + ha-kube: 22 Tools, ca. 65 KB Schema).
  • Alle 11 stehen unter "MCP tools -> Available" (deferred, nur Namen). Geladen sind ausschliesslich drei Claude-Docs-Tools.
  • Gesamtgewicht "MCP tools" im Startkontext: 638 Tokens (0,1 %), davon 0 durch ha-k3s.
  • Der HA-Server hat sich ohne erneuten OAuth-Flow verbunden (Tool-Liste vorhanden), der Token in mcpOAuth greift also weiter.

Entscheidung

Schwelle war: HA-Tools deferred, keine Schemas im Startkontext. Erfuellt, also akzeptabel.

Umsetzung

  • refactor(3): mkClaudeMcpActivation nimmt den vollstaendigen Server-Eintrag, damit http-Server denselben idempotenten Pfad nutzen.
  • feat(3): ha-k3s global registriert; claude-ha, mcp-ha.json, Cleanup-Block und der Hinweis in auto-mode/personal.json entfernt.
## Messung (frische Session, Claude Code 2.1.312, `/context all`) - `ha-k3s` liefert jetzt 11 Tools (vorher ha-k3s + ha-kube: 22 Tools, ca. 65 KB Schema). - Alle 11 stehen unter "MCP tools -> Available" (deferred, nur Namen). Geladen sind ausschliesslich drei Claude-Docs-Tools. - Gesamtgewicht "MCP tools" im Startkontext: 638 Tokens (0,1 %), davon 0 durch `ha-k3s`. - Der HA-Server hat sich ohne erneuten OAuth-Flow verbunden (Tool-Liste vorhanden), der Token in `mcpOAuth` greift also weiter. ## Entscheidung Schwelle war: HA-Tools deferred, keine Schemas im Startkontext. Erfuellt, also akzeptabel. ## Umsetzung - `refactor(3)`: `mkClaudeMcpActivation` nimmt den vollstaendigen Server-Eintrag, damit http-Server denselben idempotenten Pfad nutzen. - `feat(3)`: `ha-k3s` global registriert; `claude-ha`, `mcp-ha.json`, Cleanup-Block und der Hinweis in `auto-mode/personal.json` entfernt.
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
mandlm/home-manager#3
No description provided.