chrome-bookmarks-mcp

In Arbeit — Walking Skeleton. Werkzeuge kommen nach und nach hinzu; siehe docs/milestones/.

Ein MCP-Server, der Claude Lese-/Schreibzugriff auf Chrome- (und Brave/Edge-) Lesezeichen für die Neuorganisation durch Agenten bietet: Baumanalyse, Vorschläge für Ordnerstrukturen, Stapelpläne für Verschieben/Umbenennen/Löschen mit Snapshots und Rollback, Deduplizierung, Erkennung toter Links und Erkennung veralteter Lesezeichen über die Chrome-Verlaufsdatenbank.

Architektur

Claude Desktop / Claude Code
        ⇅ stdio (MCP)
  packages/mcp-server   (Node.js / TypeScript, SDK-free tool seam)
        ⇅ WebSocket on 127.0.0.1:<PORT>   (localhost only)
  packages/extension    (Manifest V3 service worker)
        ⇅ chrome.bookmarks API
  Live Chrome — changes visible instantly, sync-safe

Schreibvorgänge erfolgen nur über die Erweiterung (chrome.bookmarks); die Bookmarks-Datei von Chrome wird nie geschrieben. Lesezugriffe analysieren derzeit die Bookmarks-Datei; Live-Lesezugriffe über die Erweiterung folgen mit einem späteren Meilenstein.

Werkzeuge

Schreibwerkzeuge (geplant: plan_*, apply_plan, rollback) sind ausgeblendet, es sei denn, BOOKMARKS_ENABLE_WRITE=1; jedes verwendet standardmäßig dryRun: true und erstellt zuerst Snapshots. Siehe docs/adr/0002-write-path-and-safety.md.

Schnellstart (Claude Code, aus diesem Repository)

pnpm install && pnpm build

.mcp.json im Stammverzeichnis des Repositorys registriert den Server als chrome-bookmarks. Frag: "wie ist der Zustand meiner Lesezeichen-Brücke?" → bookmarks_status. Für Live-Zugriff lade die Erweiterung: chrome://extensions → Entwicklermodus → Entpackte Erweiterung laden → packages/extension/dist.

Konfiguration (Umgebungsvariablen): BOOKMARKS_BROWSER (chrome|brave|edge) · BOOKMARKS_PROFILE (Default) · BOOKMARKS_WS_PORT (48765; die Erweiterung liest chrome.storage.local.wsPort, Standard 48765) · BOOKMARKS_ENABLE_WRITE · BOOKMARKS_FILE (überschreibt den Pfad) · BOOKMARKS_LOG_LEVEL.

Entwicklung

./init.sh            # deps, typecheck, build, smoke
pnpm verify          # typecheck + lint + test — the only definition of "done"
make ext             # build the unpacked extension → packages/extension/dist
pnpm -F @chrome-bookmarks-mcp/server inspect   # MCP Inspector

Wie dieses Repository mit Agenten entwickelt wird: CLAUDE.md (Regeln), CONTEXT.md (Vokabular), docs/adr/ (Entscheidungen), docs/milestones/ (der einzige aktive Plan), docs/blessed-paths/ (Rezepte), .claude/ (Berechtigungen, Hooks, Subagenten, pfadbezogene Regeln).

KI-Attribution

KI-generierte Zeilen werden mit Git AI über Git-Notizen verfolgt (git log --show-notes=ai, git ai stats).

Lizenz

MIT