elentra-local-connector

Ein privater, lokaler, schreibgeschützter MCP-Connector, der es Claude Desktop ermöglicht, Ihre eigenen uOttawa-Elentra-Daten zu durchsuchen — indem er sich Ihre vorhandene authentifizierte Chrome-Sitzung zunutze macht, anstatt irgendwelche Anmeldedaten zu speichern.

Spezifikation: PRD-FINAL.md ist maßgeblich. Status: schreibgeschützt. write_enabled = false ist eine Buildzeit-Konstante.

Was „live“ hier bedeutet

Einigermaßen aktuell, solange der Connector aktiv ist — niemals eine Push-Garantie. Elentra bietet keine Webhooks, kein WebSocket und kein SSE, daher pollt dieser Connector. Das Authentifizierungstoken ist 60 Minuten gültig, also sind veraltete Daten der Normalfall; jede Tool-Antwort enthält fetched_at, is_stale und staleness_seconds, sodass Claude „Stand vor 3 Stunden“ sagt, anstatt zu implizieren, dass die Daten live sind.

Architektur

Chrome MV3 extension   has the session · owns the allowlist · GET only
        │              no chrome.cookies · no chrome.scripting
        ▼  native messaging
relay                  thin, stateless, ~100 LOC
        │  unix socket (0600)
        ▼
daemon (launchd)       sole DB writer · parsers · ICS poller · audit
        │  direct SQLite read-only (WAL)
        ▼
mcp-server (stdio)     read-only tools → Claude Desktop

Bewusst vier Prozesse. Chrome erzeugt einen Native-Messaging-Host als Unterprozess, sodass ein Daemon, der dieser Host ist, mit Chrome sterben würde — was unbeaufsichtigtes ICS-Polling beendet — und bei jedem Service-Worker-Neustart neu erzeugt würde, was zwei Schreiber gegen eine WAL-Datenbank ergibt, die nur einen erlaubt. Das Relay kostet ~100 zustandslose Zeilen und beseitigt beide Probleme.

Einrichtung

Der Build ist automatisiert; die manuelle Einrichtung nicht. Siehe docs/HANDOFF.md — etwa 10 Minuten an Chrome- und macOS-Schritten, die nicht skriptbar sind.

pnpm install
pnpm bootstrap  # build, keys, index, daemon, health — idempotent, re-runnable

pnpm bootstrap erledigt alles Skriptbare und berichtet, was übrig bleibt. Die einzelnen Schritte, falls Sie sie selbst ausführen möchten:

pnpm verify     # typecheck + lint + test + secret scan — the gate
pnpm build      # four bundles: mcp, daemon, relay, extension
pnpm build:mcpb # the Claude Desktop .mcpb — separate from pnpm build
pnpm health     # live diagnostics, after handoff

pnpm install && pnpm verify läuft vollständig offline: Fixtures sind synthetisch, und tests/no-network.setup.ts ersetzt fetch durch eine Funktion, die eine Ausnahme auslöst, sodass jeder Test, der auf das Netzwerk zugreift, fehlschlägt, anstatt stillschweigend zu bestehen.

Garantien

• Speichert niemals Ihr Passwort; es existiert kein Passwort-Codepfad.

• Exportiert niemals Browser-Cookies.

• Automatisiert niemals Login, MFA oder SSO-Verlängerung — bei Ablauf stoppt es und teilt es Ihnen mit.

• Legt niemals ein generisches request(method, url)-Tool für das Modell offen.

• Das Repo enthält nur Code; Fixtures sind 100 % synthetisch.

Siehe SECURITY.md für die Invarianten und PRIVACY.md für das, was Anthropic erreicht.

Lizenz

MIT — siehe LICENSE.