better-bear について
better-bear は、Bear のノートを CloudKit 経由で読み取り、検索、作成、編集、タグ付けできる MCP サーバー兼コマンドラインツールです。LLM がインデックスをたどって参照できる、整理・同期されたコンテキストライブラリも備えています。
主な機能
- 01CloudKit 経由での Bear ノートへのアクセス
- 02ノートの読み取り、検索、作成、編集
- 03タグと添付ファイルの管理
- 04#context タグから同期されるコンテキストライブラリ
- 05ヘルスチェック付きの bcli コマンドライン
活用シーン
- 01Claude による Bear ノートの検索と整理
- 02選択したノートの LLM 用コンテキストフォルダへの同期
- 03コマンドラインからのノート内容の確認や追記
MCP 対応
MCP サーバーとして、Claude Desktop や Claude Code などの MCP クライアントに、ノート、タグ、TODO、添付ファイル、検索、コンテキストライブラリにわたる 34 個のツールを提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
better bear
CloudKit 経由で Bear のノートを扱う MCP サーバーと CLI です。LLM が利用しやすいように最適化された、厳選・同期済みのノートフォルダーであるコンテキストライブラリも含まれています。Karpathy の LLM ナレッジベースのパターンに着想を得ています。
ドキュメント全文はこちら:better-bear.com
インストール
CLI をインストールしてから、Claude に接続します。
curl -sL https://raw.githubusercontent.com/KuvopLLC/better-bear/main/install.sh | bash
bcli auth
bcli mcp install
bcli バイナリをインストールし、iCloud で認証して、Claude Desktop(.mcpb バンドル経由)と Claude Code の両方に MCP サーバーをセットアップします。
その他のインストール方法
| 方法 | コマンド |
|---|---|
| Claude Desktop のみ | bcli mcp install --desktop-only |
| Claude Code のみ | bcli mcp install --code-only |
| Claude Code(直接) | claude mcp add better-bear -- npx -y better-bear |
| 設定ファイル | bcli mcp install --json |
| .mcpb バンドル | 最新リリースからダウンロードして、ダブルクリック |
管理
bcli mcp status # check what's configured
bcli mcp uninstall # remove from Claude Desktop and Claude Code
bcli mcp reinstall # clean uninstall + install
bcli upgrade # upgrade bcli binary
CLI
すべてのコマンドは、ターミナルから単独でも実行できます。
bcli ls # list notes
bcli search "query" # full-text search
bcli create "Title" -b "Body" # create a note
bcli edit <id> --append "text" # append to a note
bcli tags # list all tags
bcli attach <id> photo.jpg # attach a file
bcli stats # library statistics
bcli health # health check
コマンドの全リファレンスについては、better-bear.comをご覧ください。
コンテキストライブラリ
Bear のノートの一部を、Claude がインデックス優先の検索で参照できる、同期済みの厳選コンテキストフォルダーに変換します。Bear でノートに #context タグを付けて同期すると、Claude はコンパクトなインデックスから関連ファイルを見つけ、すべてではなく必要なものだけを読み込みます。
bcli context init # one-time setup
bcli context sync # pull qualifying notes
bcli context add <id> --subtag research # tag a note for inclusion
bcli context status # health check
または Claude に 「コンテキストライブラリをセットアップして」 と伝えると、MCP ツールを使ってすべて処理します。
アーキテクチャは Karpathy の3フォルダーパターンに沿っています。bear/(CloudKit から同期)、external/(PDF、エクスポート、共有ドキュメント)、inbox/(仕分け用の一時保存場所)で構成されます。index.md マニフェストがすべての項目を対応付けます。ドキュメント全文については、better-bear.comをご覧ください。
MCP ツール
ノート、タグ、TODO、添付ファイル、検索、フロントマター、統計、ヘルスチェック、コンテキストライブラリを扱う34個のツールがあります。一覧については、MCP サーバーの READMEをご覧ください。
コントリビューター
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。