Bear Notes MCP 서버

모든 AI 어시스턴트에서 Bear 메모를 검색, 읽기, 생성 및 업데이트하세요. 클릭 한 번으로 설치 가능한 Claude Desktop 확장 프로그램 및 모든 MCP 클라이언트를 위한 독립형 npm 패키지로 제공됩니다.

이 로컬 전용 MCP 서버는 빠른 OCR 지원 검색을 위해 Bear의 SQLite 데이터베이스를 읽고, 쓰기 작업에는 Bear의 기본 API를 사용합니다. 완벽한 개인정보 보호: 외부 연결이 없으며 모든 처리는 Mac에서 이루어집니다.

프롬프트 예시:

우리 대화를 요약해서 새로운 Bear 메모로 만들어줘

내 사이드 프로젝트 아이디어에 대해 인터뷰하고 핵심 내용을 Bear 메모에 기록해줘

내 "제품 출시" 메모의 개요를 재구성하는 것을 도와줘

블로그 포스트 아이디어를 브레인스토밍하자 — 가장 좋은 아이디어를 내 Bear 메모에 저장하고 진행하면서 다듬어보자

✨ 주요 기능

• 13개의 MCP 도구: 메모 검색, 읽기, 생성, 업데이트, 태그 지정 및 보관

• OCR 검색 — 첨부된 이미지와 PDF 내부의 텍스트를 찾습니다

• 날짜 기반 검색 — 상대적 날짜 지원 ("어제", "지난주", "지난달 초")

• 태그 관리 — 태그를 트리 구조로 나열, 태그 없는 메모 찾기, 메모에 태그 추가

• 새 메모 규칙 (선택 사항) — 태그를 하단이 아닌 제목 바로 아래에 배치

• 콘텐츠 교체 (선택 사항) — 전체 메모 본문 또는 특정 섹션 교체

• 로컬 전용 — 네트워크 호출 없음, 모든 데이터는 Mac에 유지

📦 설치

Claude Desktop 확장 프로그램

전제 조건: Bear 앱이 설치되어 있어야 하며 Claude Desktop이 설치되어 있어야 합니다.

1. Releases에서 최신 bear-notes-mcpb-*.mcpb 확장 파일 다운로드

2. Claude Desktop이 실행 중인지 확인 (실행 중이 아니라면 시작)

3. 확장 파일을 더블 클릭 — Claude Desktop에 설치 프롬프트가 표시됩니다

   어떤 이유로 더블 클릭이 작동하지 않으면, Claude -> 설정 -> 확장 프로그램 -> 고급 설정 -> "확장 프로그램 설치"를 클릭하세요.

4. 완료!

Claude에게 "'회의'에 대한 내 Bear 메모 검색해줘"와 같은 쿼리로 Bear 메모를 검색하도록 요청하세요. 응답에 메모가 나타날 것입니다!

독립형 MCP 서버

이 Bear Notes MCP 서버를 Claude Code, Cursor, Codex 또는 다른 AI 어시스턴트와 함께 사용하고 싶으신가요?

요구 사항: Node.js 24.13.0+

Claude Code (한 줄 명령)

claude mcp add bear-notes --transport stdio -- npx -y bear-notes-mcp@latest

기타 AI 어시스턴트

MCP 구성 파일에 추가:

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

더 많은 설치 옵션 및 로컬 개발 설정 — NPM.md

🛠️ 도구

• bear-open-note - 첨부된 이미지와 PDF의 OCR 텍스트를 포함하여 Bear 메모의 전체 텍스트 콘텐츠 읽기

• bear-create-note - 제목, 콘텐츠, 태그를 선택적으로 포함하여 Bear 라이브러리에 새 메모 생성

• bear-search-notes - 텍스트 콘텐츠 검색, 태그 또는 날짜 범위로 필터링하여 메모 찾기. 첨부 파일의 OCR 검색 포함

• bear-add-text - Bear 메모의 시작이나 끝, 또는 헤더로 식별된 특정 섹션 내에 텍스트 삽입

• bear-replace-text - 기존 Bear 메모의 콘텐츠 교체 — 전체 본문 또는 특정 섹션. 설정에서 콘텐츠 교체 기능이 활성화되어 있어야 함.

• bear-add-file - 기존 Bear 메모에 파일 첨부. 로컬 파일 경로(권장) 또는 base64 인코딩 콘텐츠 제공.

• bear-list-tags - Bear 라이브러리의 모든 태그를 메모 개수가 포함된 계층적 트리로 나열

• bear-find-untagged-notes - Bear 라이브러리에서 태그가 지정되지 않은 메모 찾기

• bear-add-tag - 기존 Bear 메모에 하나 이상의 태그 추가

• bear-archive-note - Bear 메모를 삭제하지 않고 활성 목록에서 제거하기 위해 보관

• bear-rename-tag - Bear 라이브러리의 모든 메모에서 태그 이름 변경

• bear-delete-tag - 메모에 영향을 주지 않고 Bear 라이브러리의 모든 메모에서 태그 삭제

• bear-grab-url - 웹 페이지를 Bear 메모로 저장. Bear가 페이지를 가져와 마크다운으로 변환.

⚙️ 구성

디버그 로깅

문제 해결을 위해 상세 로깅을 활성화합니다.

• Claude Desktop: 설정 → 확장 프로그램 → 구성 (Bear Notes 옆) → "디버그 로깅" 토글 → 저장 → Claude 재시작

• 독립형 MCP 서버: 환경 변수 UI_DEBUG_TOGGLE=true 설정

새 메모 규칙

기본적으로 Bear는 API를 통해 생성될 때 메모 하단에 태그를 배치합니다. 이 옵션을 활성화하면 태그를 하단 대신 제목 바로 아래에 가로 구분선과 함께 배치합니다.

┌──────────────────────────────┐
│ # Meeting Notes              │  ← Note title
│ #work #meetings              │  ← Tags right after title
│                              │
│ ---                          │  ← Separator
│                              │
│ Lorem Ipsum...               │  ← Note body
└──────────────────────────────┘

• Claude Desktop: 설정 → 확장 프로그램 → 구성 (Bear Notes 옆) → "새 메모 규칙" 토글 → 저장 → Claude 재시작

• 독립형 MCP 서버: 환경 변수 UI_ENABLE_NEW_NOTE_CONVENTION=true 설정

규칙이 활성화된 독립형 구성 예시:

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

콘텐츠 교체

bear-replace-text 도구를 활성화하여 기존 메모의 콘텐츠(전체 본문 또는 헤더 아래의 특정 섹션)를 교체합니다.

• Claude Desktop: 설정 → 확장 프로그램 → 구성 (Bear Notes 옆) → "콘텐츠 교체" 토글 → 저장 → Claude 재시작

• 독립형 MCP 서버: 환경 변수 UI_ENABLE_CONTENT_REPLACEMENT=true 설정

콘텐츠 교체가 활성화된 독립형 구성 예시:

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

기술 세부 정보

이 서버는 검색/읽기 작업을 위해 Bear Notes SQLite 데이터베이스를 직접 읽고, 쓰기 작업에는 Bear의 X-callback-URL API를 사용합니다. 모든 데이터 처리는 외부 네트워크 호출 없이 로컬 기기에서 수행됩니다.

지원 플랫폼

Bear 데스크톱은 macOS에서만 작동하므로 macOS만 지원합니다.

로그

Claude Desktop:

• MCP 서버 로그는 ~/Library/Logs/Claude/main.log에 저장되며 bear-notes-mcp를 찾으세요

• MCP 전송 로그는 ~/Library/Logs/Claude/mcp-server-Bear\ Notes.log에 저장됩니다

독립형 MCP 서버:

• 로그는 stderr에 기록됩니다; UI_DEBUG_TOGGLE=true로 디버그 로깅을 활성화하세요

FAQ

내 데이터를 훔쳐갈 수 있나요?

아니요. 서버는 Bear의 로컬 데이터베이스(Bear 앱이 보여주는 데이터와 동일)만 읽고 Bear의 기본 API를 사용하여 메모에 텍스트를 추가합니다. 네트워크 전송이나 외부 서버는 없습니다.

왜 Bear 앱의 기본 x-callback-url API가 아닌 SQLite를 사용하나요?

읽기 작업(검색/열기)의 경우, x-callback-url API는 x-success 응답으로 메모 데이터를 반환합니다. 이는 응답을 처리하기 위해 서버나 사용자 정의 바이너리가 필요한데, 이는 위험하고 불안정합니다. 직접적인 SQLite 읽기 전용 액세스가 메모를 검색하고 읽는 데 더 간단하고 안정적입니다.

왜 타사 패키지가 아닌 기본 Node.js SQLite를 사용하나요?

이는 타사 노드 패키지에서 SQLite 바이너리를 제공하는 것을 방지합니다. 이는 공급망 위험을 초래하고 Claude Desktop 확장 프로그램이 macOS에서 실행되는 것을 차단합니다.

Anthropic은 타사 SQLite 바이너리에 서명하지 않으므로, macOS 보안 시스템은 Anthropic이 서명한 Claude 프로세스가 타사가 서명한 다른 바이너리를 실행하려고 한다고 판단하여 차단합니다. 결과적으로 Claude Desktop은 확장 프로그램을 실행할 수 없습니다.

확장 프로그램을 설치할 때 "설치하면 컴퓨터의 모든 항목에 대한 액세스 권한이 부여됩니다."라는 빨간색 경고가 표시됩니다. 무슨 뜻인가요?

이는 이 확장 프로그램이 Mac의 Bear SQLite 데이터베이스에 액세스해야 한다는 사실에 대해 Claude for Desktop이 반응하는 방식입니다.

Claude 경고 시스템은 단일 파일에 대한 액세스 필요성(확장 프로그램이 수행하는 작업)과 모든 파일에 대한 액세스 필요성(확장 프로그램이 수행하지 않는 작업)을 구분하지 않습니다.

이를 검증하는 방법 중 하나는 확장 프로그램을 설치하기 전에 Claude에게 코드베이스(매우 작음)를 분석하도록 요청하는 것입니다.

버그를 보고하거나 기여하려면 어떻게 해야 하나요?

이슈나 토론을 사용하세요! 피드백이나 제안을 환영하며, 이 프로젝트를 더 좋게 만드는 데 도움을 주시면 감사하겠습니다! ❤️

최신 정보 유지

새 버전이 출시될 때 알림을 받으려면 릴리스 공지를 구독하세요:

새 릴리스가 있을 때 reddit.com/r/bearapp/에도 게시합니다.