
vasylenko/bear-notes-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
vasylenko/bear-notes-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.
개요
vasylenko/bear-notes-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.
개요(AI 번역)
Bear Notes를 위한 비공식적이고 의견이 뚜렷한 MCP 서버로, 서브스트링 매칭 대신 관련성 순위 검색을 기반으로 구축되었습니다. 결과는 제목, 본문, 계층적 태그를 따라 순위별로 제공되며, 스니펫과 조합 가능한 필터(태그, 날짜, 고정)가 있습니다. 읽기는 Bear의 SQLite 데이터베이스와 직접 대조되며, 쿼리에 Bear 앱이 필요하지 않습니다.
Bear의 자체 URL 핸들러를 통해 경로를 작성 — 원자적이고 Bear가 검증합니다. 오프라인 우선: 네트워크 호출, 텔레메트리 없음, 모든 처리가 Mac에서 가능합니다. 모든 MCP 클라이언트와 호환됩니다 — Claude Desktop, Claude Code, Codex, Gemini, Cursor. 원클릭 .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:
설치
npx -y bear-notes-mcp@latest설정
{
"mcpServers": {
"bear-notes": {
"command": "npx",
"args": ["-y", "bear-notes-mcp@latest"]
}
}
}