claude-desktop-bridge

Claude-Desktop-Bridge

Claude Desktop の Chat タブと Code タブで、永続的な共有メモ保管庫を使えるようにするローカル MCP サーバーです。Claude は、タブを切り替えるたびにコンテキストを再構築する代わりに、5 つのツール — save_note、get_notes、search_notes、update_note、delete_note — を使って必要な情報だけを取得します。

インストール

1. Releases から claude-desktop-bridge.mcpb をダウンロードします。
2. Claude Desktop のウィンドウにドラッグ＆ドロップします。または「Settings」→「Extensions」→「Advanced settings」→「Install Extension…」を選択します。
3. 設定は不要です。保管庫は ~/.claude-bridge/vault.db に保存されます。

ツール

ツール	説明
save_note	新しいメモを保存します（タイトル、内容、任意のタグ、任意のプロジェクト）
get_notes	ID、タグ、またはプロジェクトでメモを取得します。新しいものが先に表示されます
search_notes	メモのタイトルと内容を全文検索します
update_note	既存のメモのタイトル、内容、タグ、またはプロジェクトを更新します
delete_note	ID を指定してメモを完全に削除します

メモには任意の project フィールドを設定できるため、複数のコードベースでの作業を分けて管理できます。プロジェクトごとにメモを個別に絞り込めます。

使い方

どちらのタブでも普段どおりに話しかけてください。Claude は必要に応じて自動でツールを呼び出します。手動で呼び出す必要はありません。

• 常に自動で記録するのではなく、必要に応じて活用します。 Claude は保存または検索する価値があるものを判断します。すべてのメッセージを記録するわけではありません。何かを残したいときは、「あとで使えるように覚えておいて」と伝えてください。
• 複数のコードベースで作業する場合は、プロジェクトごとにタグを付けてください。そうすれば、あるリポジトリのコンテキストで検索しても、別のプロジェクトのメモが表示されません。
• Chat タブの「Projects」は Code タブのフォルダーに自動でリンクされません。 その Project の Custom Instructions に、「このプロジェクトは my-repo コードベースに対応しています。project: 'my-repo' を指定して Claude-Desktop-Bridge を使用してください」と記載してください。

利用できる環境

環境	そのまま使えますか？
Claude Desktop — Chat タブ	✅ はい
Claude Desktop — Code タブ（ローカルセッション）	✅ はい
単体の claude CLI（ターミナル。Desktop は不要）	⚠️ 追加の手順が 1 つ必要です
Claude Code on the Web／クラウドセッション	❌ 利用できません（ローカル専用サーバー）

単体の CLI は Desktop の拡張機能設定を読み込みません。明示的に登録してください。

# macOS or WSL — imports every MCP server Desktop has configured
claude mcp add-from-claude-desktop

# Any platform, including Linux — register this repo's built server:
claude mcp add --scope user claude-desktop-bridge -- node /path/to/claude-desktop-bridge/server/index.js

--scope user を指定すると、すべてのターミナルプロジェクトで利用できます。Desktop 拡張機能と同じ ~/.claude-bridge/vault.db を読み込むため、メモは共有されます。

メモのトークン消費を抑えたいですか？ cdb-companion は save_note／update_note に渡す前に内容を圧縮します。

ソースからビルドする

npm install
npm run build   # bundles src/index.ts -> server/index.js
npm run pack     # produces claude-desktop-bridge.mcpb

Node.js 22 以降が必要です（組み込みの node:sqlite を使用）。拡張機能は Claude Desktop 自身の Node ランタイムで実行されるため、エンドユーザーが Node をインストールする必要はありません。チェック項目：npm ci + npm test（.github/workflows/npm-project.yml を参照）。

設定

• 保管庫 → ~/.claude-bridge/vault.db（ローカル SQLite）。拡張機能をアンインストールしてもファイルは残ります。delete_note で削除するか、ファイルを削除するまでメモは保持されます。
• ネットワーク → 使用しません。サーバーコンポーネント、外部へのリクエスト、分析、テレメトリはありません。

貢献

PR を作成する前に、イシューを作成して相談してください。編集するファイルは src/index.ts です。server/index.js は生成ファイルです。PR は npm ci + npm test に合格する必要があります。

ライセンス

MIT