VB

vasylenko/bear-notes-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

207 stars 21 forks Качество 78 Тренд 21Apache-2.0

vasylenko/bear-notes-mcp — это кандидат на сервер MCP, импортированный из https://github.com/vasylenko/bear-notes-mcp.

Обзор

vasylenko/bear-notes-mcp — это кандидат на сервер MCP, импортированный из https://github.com/vasylenko/bear-notes-mcp.

Обзор (машинный перевод)

Неофициальный, мнекционный MCP-сервер для Bear Notes — построенный вокруг поиска по релевантности, а не на сопоставлении подстрок. Результаты ранжируются по названиям, телам и иерархическим тегам с фрагментами и комбинируемыми фильтрами (тег, дата, закрепленные). Чтения работают напрямую с базой данных Bear SQLite — для запросов не требуется приложение Bear.

Записывает маршрут через собственный обработчик URL Bear — атомарный и валидированный Bear. Офлайн-первый: нет сетевых вызовов, нет телеметрии, вся обработка на вашем Mac. Работает с любым MCP-клиентом — Claude Desktop, Claude Code, Codex, Gemini, Cursor. Поставляется как расширение .mcpb в один клик или как отдельный пакет npm.

Примеры запросов:

Найдите подробное погружение, которое я написал о экспортных конвейерах, где-то под #engineering/

Добавьте сегодняшние решения в раздел «Решения» моей еженедельной оперативной записки

Собрать каждую заметку под #research/llm-evals в план опроса

Найдите свои заметки с тегом #blog/черновики и составьте план поста на этой неделе

✨ Ключевые особенности

  • По умолчанию только для чтения — переключать режим редактирования для записей. 4 инструмента всегда включены (поиск, открытие, поиск неотмеченных, список тегов); Ещё 8 в режиме редактирования для создания, редактирования, прикрепления, тегирования, архивирования

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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:

Открыть полный README на GitHub

Установка

npx -y bear-notes-mcp@latest
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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