chrome-bookmarks-mcp

进行中——可运行的骨架。工具将逐步落地；参见 docs/milestones/。

一个 MCP 服务器，让 Claude 对 Chrome（以及 Brave/Edge）书签拥有读/写访问权限，用于智能代理式重组：树分析、文件夹结构建议、带快照和回滚的批量移动/重命名/删除计划、去重、死链检测，以及通过 Chrome 的 History 数据库进行过期书签检测。

架构

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）进行；从不写入 Chrome 的 Bookmarks 文件。读取目前解析 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/（权限、钩子、子智能体、路径作用域规则）。

AI 归属

AI 生成的代码行通过 git notes 使用 Git AI 进行跟踪（git log --show-notes=ai、git ai stats）。

许可证

MIT