mcpField
B
better-bear

better-bear

ローカル
github.com/mreider生産性6827 週間前に更新

better-bear について

better-bear は、Bear のノートを CloudKit 経由で読み取り、検索、作成、編集、タグ付けできる MCP サーバー兼コマンドラインツールです。LLM がインデックスをたどって参照できる、整理・同期されたコンテキストライブラリも備えています。

主な機能

  1. 01CloudKit 経由での Bear ノートへのアクセス
  2. 02ノートの読み取り、検索、作成、編集
  3. 03タグと添付ファイルの管理
  4. 04#context タグから同期されるコンテキストライブラリ
  5. 05ヘルスチェック付きの bcli コマンドライン

活用シーン

  1. 01Claude による Bear ノートの検索と整理
  2. 02選択したノートの LLM 用コンテキストフォルダへの同期
  3. 03コマンドラインからのノート内容の確認や追記

MCP 対応

MCP サーバーとして、Claude Desktop や Claude Code などの MCP クライアントに、ノート、タグ、TODO、添付ファイル、検索、コンテキストライブラリにわたる 34 個のツールを提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"mreider-better-bear": {
"command": "npx",
"args": [
"-y",
"better-bear"
]
}
}
}
起動コマンドnpx -y better-bear

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmbetter-bear0.4.21

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

better bear

better-bear MCP サーバー

ビルド リリース npm ライセンス: MIT better-bear MCP サーバー コーヒーをおごる

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をご覧ください。

コントリビューター

mreider program247365 asabirov darronz

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。