chrome-bookmarks-mcp

Trabajo en curso — esqueleto funcional. Las herramientas llegan por partes; consulta docs/milestones/.

Un servidor MCP que da a Claude acceso de lectura/escritura a los marcadores de Chrome (y Brave/Edge) para una reorganización agéntica: análisis del árbol, propuestas de estructura de carpetas, planes de mover/renombrar/eliminar por lotes con instantáneas y reversión, deduplicación, detección de enlaces muertos y detección de marcadores obsoletos mediante la base de datos del historial de Chrome.

Arquitectura

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

Las escrituras se realizan solo a través de la extensión (chrome.bookmarks); el archivo Bookmarks de Chrome nunca se escribe. Las lecturas actualmente analizan el archivo Bookmarks; las lecturas en vivo mediante la extensión llegarán en un hito posterior.

Herramientas

Las herramientas de escritura (planeadas: plan_*, apply_plan, rollback) están ocultas a menos que BOOKMARKS_ENABLE_WRITE=1; cada una tiene por defecto dryRun: true y toma instantáneas primero. Consulta docs/adr/0002-write-path-and-safety.md.

Inicio rápido (Claude Code, desde este repositorio)

pnpm install && pnpm build

.mcp.json en la raíz del repositorio registra el servidor como chrome-bookmarks. Pregunta: "¿cuál es el estado de mi puente de marcadores?" → bookmarks_status. Para acceso en vivo, carga la extensión: chrome://extensions → Modo desarrollador → Cargar descomprimida → packages/extension/dist.

Configuración (env): BOOKMARKS_BROWSER (chrome|brave|edge) · BOOKMARKS_PROFILE (Default) · BOOKMARKS_WS_PORT (48765; la extensión lee chrome.storage.local.wsPort, por defecto 48765) · BOOKMARKS_ENABLE_WRITE · BOOKMARKS_FILE (ruta de anulación) · BOOKMARKS_LOG_LEVEL.

Desarrollo

./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

Así se desarrolla este repositorio con agentes: CLAUDE.md (reglas), CONTEXT.md (vocabulario), docs/adr/ (decisiones), docs/milestones/ (el único plan activo), docs/blessed-paths/ (recetas), .claude/ (permisos, hooks, subagentes, reglas con ámbito de ruta).

Atribución de IA

Las líneas generadas por IA se rastrean con Git AI mediante notas de git (git log --show-notes=ai, git ai stats).

Licencia

MIT