VB

vasylenko/bear-notes-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

207 stars 21 forks 品質 78 トレンド 21Apache-2.0

vasylenko/bear-notes-mcp は、https://github.com/vasylenko/bear-notes-mcp. からインポートされた MCP サーバー候補です。

概要

vasylenko/bear-notes-mcp は、https://github.com/vasylenko/bear-notes-mcp. からインポートされた MCP サーバー候補です。

概要(AI 翻訳)

Bear Notesの非公式で意見を述べたMCPサーバーで、サブストリングマッチングではなく関連性順位検索を中心に構築されています。結果はタイトル、本文、階層的タグごとにランク付けされ、スニペットや組み合わせ可能なフィルター(タグ、日付、ピン留め)が使われます。読み取りはBearのSQLiteデータベースに直接表示され、クエリにBearアプリは必要ありません。

Bear独自のURLハンドラを通じてルートを書き込み、Bearによってアトミックかつ検証されています。オフライン優先:ネットワーク通話やテレメトリなし、すべての処理はMac上で行われます。Claude Desktop、Claude Code、Codex、Gemini、Cursorなど、あらゆるMCPクライアントで動作します。ワンクリックの**.mcpb拡張またはスタンドアロンのnpmパッケージ*として提供されます。

例示のプロンプト:

エクスポートパイプラインについて私が書いた詳細な解説は、#engineering/のどこかにあります。

本日の決定を私の週刊作戦ノートの「決定」セクションに添付してください

#research/LLM評価の下のすべてのノートを調査アウトラインにまとめます

#blog/draftsタグ付きのノートを見つけて、今週の投稿アウトラインを作成してください

✨ 主な特徴

  • デフォルトで読み取り専用 — 書き込み時に編集モードを切り替える 4つのツールは常に稼働(検索、開く、タグなしの検索、リストタグ);編集モードには作成、編集、添付、タグ付け、アーカイブ用の8つのツールがあります

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Bear Notes MCP Server

An unofficial, opinionated MCP server for Bear Notes — built around relevance-ranked search instead of substring matching. Results come ranked across titles, bodies, and hierarchical tags, with snippets and combinable filters (tag, date, pinned). Reads run direct against Bear’s SQLite database — no Bear app required for queries.

Writes route through Bear’s own URL handler — atomic and validated by Bear. Offline-first: no network calls, no telemetry, all processing on your Mac. Works with any MCP client — Claude Desktop, Claude Code, Codex, Gemini, Cursor. Ships as a one-click .mcpb extension or a standalone npm package.

Example prompts:

Find the deep-dive I wrote on export pipelines, somewhere under #engineering/

Append today’s decisions to the ‘Decisions’ section of my Weekly Ops note

Pull every note under #research/llm-evals into a survey outline

Find my notes tagged #blog/drafts and draft this week’s post outline

✨ Key Features

  • Read-only by default — flip Edit Mode for writes. 4 tools always on (search, open, find untagged, list tags); 8 more in Edit Mode for create, edit, attach, tag, archive
  • Relevance-ranked search across titles, bodies, and tags — finds the right note, not just the ones that contained your literal words
  • Date-based search with relative dates (“yesterday”, “last week”, “start of last month”)
  • Hierarchical tag management — view tags as a tree with note counts; rename or delete a tag across the whole library
  • Surgical writes — append at a specific heading or replace a section without rewriting the whole note
  • File attachments — attach images, PDFs, and documents up to 25 MB; symlinks rejected for safety
  • New note convention (opt-in) — place tags right after the title instead of at the bottom
  • Local-first — direct read-only SQLite reads, native node:sqlite, no network calls, no telemetry

[!NOTE] Complete privacy (except the data you send to your AI provider when using an AI assistant, of course): this server makes no external connections. All processing happens locally on your Mac using Bear’s own database and API. There is no extra telemetry, usage statistics or anything like that.

👤 Who is this for

This is an unofficial, opinionated alternative to the native Bear MCP. It fits when:

GitHub で README 全文を見る

インストール

npx -y bear-notes-mcp@latest
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "bear-notes": { "command": "npx", "args": ["-y", "bear-notes-mcp@latest"] } } }