chrome-bookmarks-mcp

進行中 — ウォーキングスケルトン。ツールはスライス単位で追加されます。docs/milestones/ を参照。

Chrome（および Brave/Edge）のブックマークへの読み書きアクセスを Claude に提供する MCP サーバーです。エージェントによる 再編成（ツリー解析、フォルダ構造の提案、スナップショットとロールバックを備えた一括移動・名前変更・削除プラン、 重複排除、デッドリンク検出、そして 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）。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