chrome-bookmarks-mcp

В разработке — рабочий скелет. Инструменты добавляются по частям; см. docs/milestones/.

MCP-сервер, который предоставляет Claude доступ на чтение и запись к закладкам Chrome (а также Brave/Edge) для реорганизации агентами: анализ дерева, предложения по структуре папок, пакетные планы перемещения/переименования/удаления со снимками и откатом, дедупликация, обнаружение битых ссылок и обнаружение устаревших закладок через базу данных History браузера Chrome.

Архитектура

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

Запись идёт только через расширение (chrome.bookmarks); файл Bookmarks Chrome никогда не записывается. Чтение в настоящее время разбирает файл Bookmarks; «живое» чтение через расширение появится на одном из следующих этапов.

Инструменты

Инструменты записи (запланированы: plan_*, apply_plan, rollback) скрыты, если не задано BOOKMARKS_ENABLE_WRITE=1; каждый по умолчанию использует dryRun: true и сначала создаёт снимок. См. docs/adr/0002-write-path-and-safety.md.

Быстрый старт (Claude Code, из этого репозитория)

pnpm install && pnpm build

.mcp.json в корне репозитория регистрирует сервер как chrome-bookmarks. Спросите: «каково состояние моего моста закладок?» → bookmarks_status. Для живого доступа загрузите расширение: chrome://extensions → Режим разработчика → Загрузить распакованное → packages/extension/dist.

Конфигурация (переменные окружения): BOOKMARKS_BROWSER (chrome|brave|edge) · BOOKMARKS_PROFILE (Default) · BOOKMARKS_WS_PORT (48765; расширение читает chrome.storage.local.wsPort, по умолчанию 48765) · BOOKMARKS_ENABLE_WRITE · BOOKMARKS_FILE (путь для переопределения) · BOOKMARKS_LOG_LEVEL.

Разработка

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

Как этот репозиторий разрабатывается с агентами: CLAUDE.md (правила), CONTEXT.md (словарь), docs/adr/ (решения), docs/milestones/ (единственный активный план), docs/blessed-paths/ (рецепты), .claude/ (разрешения, хуки, субагенты, правила, ограниченные путём).

Атрибуция ИИ

Строки, сгенерированные ИИ, отслеживаются с помощью Git AI через git notes (git log --show-notes=ai, git ai stats).

Лицензия

MIT