Bear MCP Server

by bart6114
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Requires macOS with Bear app installed for the MCP server to function properly by connecting to the Bear SQLite database.

  • Connects to the Bear SQLite database in read-only mode to safely retrieve note data without modifying the underlying database.

베어 MCP 서버

Claude와 같은 AI 비서가 Bear 메모 앱에서 메모를 읽을 수 있도록 하는 MCP(Model Context Protocol) 서버입니다. 이 구현은 Bear SQLite 데이터베이스에 읽기 전용 모드로 직접 연결되므로 메모가 안전하게 유지되고 수정되지 않습니다.

빠른 시작

옵션 1: GitHub에서 설치(권장)

지엑스피1

이제 서버가 실행되어 Bear 데이터베이스에 연결됩니다.

옵션 2: 로컬에서 복제 및 실행

# Clone the repository git clone https://github.com/bart6114/my-bear-mcp-server.git cd my-bear-mcp-server # Install dependencies npm install # Build and run npm run build npm start

필수 조건

  • Bear 앱이 설치된 macOS
  • Node.js 18 이상

구성

Claude 데스크톱 앱용

~/Library/Application Support/Claude/claude_desktop_config.json 에 있는 구성 파일에 다음을 추가하세요.

{ "mcpServers": { "bear": { "command": "npx", "args": ["github:bart6114/my-bear-mcp-server"], "env": {}, "disabled": false, "autoApprove": [] } } }

Claude VS Code 확장 프로그램용

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 에 있는 구성 파일에 다음을 추가하세요.

{ "mcpServers": { "bear": { "command": "npx", "args": ["github:bart6114/my-bear-mcp-server"], "env": {}, "disabled": false, "autoApprove": [] } } }

사용 가능한 도구

Bear MCP 서버는 다음과 같은 읽기 전용 도구를 제공합니다(모든 작업은 비파괴적이며 Bear 데이터베이스를 수정할 수 없습니다).

오픈노트

제목이나 ID로 메모를 엽니다.

검색 노트

용어나 태그로 노트를 검색하세요.

태그를 얻으세요

Bear의 모든 태그를 가져옵니다.

오픈_태그

특정 태그가 있는 모든 메모를 표시합니다.

사용 예

다음은 AI 도우미를 통해 Bear MCP 도구와 상호 작용하는 방법의 예입니다.

노트 검색

AI 비서에게 특정 용어가 포함된 메모를 검색하도록 요청하세요.

Can you find all my notes about "project management"?

특정 노트 열기

AI 비서에게 제목으로 특정 메모를 검색하도록 요청하세요.

Show me my note titled "Meeting Notes - March 2025"

태그 보기

AI 비서에게 모든 Bear 태그를 나열해 달라고 요청하세요.

What tags do I have in my Bear notes?

특정 태그가 있는 노트 찾기

AI 비서에게 특정 태그가 있는 메모를 보여달라고 요청하세요.

Show me all notes with the #work tag

고급 옵션

Bear 데이터베이스가 비표준 위치에 있는 경우:

npx github:bart6114/my-bear-mcp-server --db-path /path/to/your/database.sqlite

기술적 세부 사항

읽기 전용 구현

이 MCP 서버는 엄격한 읽기 전용 연결을 사용하여 Bear SQLite 데이터베이스에 연결합니다. 이는 데이터베이스 드라이버 수준에서 적용됩니다.

// From src/bear-db.ts this.db = new Database(dbPath, { readonly: true });

이를 통해 다음이 보장됩니다.

  • 데이터베이스에서 쓰기 작업을 수행할 수 없습니다.
  • 귀하의 메모와 태그는 수정, 삭제 또는 손상될 수 없습니다.
  • 쓰기 권한을 시도하면 데이터베이스 연결이 실패합니다.

이 서버에서 수행하는 모든 작업은 데이터를 수정하지 않고 검색만 하는 SELECT 쿼리입니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

-
security - not tested
A
license - permissive license
-
quality - not tested

Claude와 같은 AI 도우미가 Bear 메모 앱에서 안전하고 읽기 전용 모드로 메모를 읽을 수 있게 해주는 모델 컨텍스트 프로토콜 서버입니다.

  1. Quick Start
    1. Option 1: Install from GitHub (Recommended)
    2. Option 2: Clone and Run Locally
  2. Prerequisites
    1. Configuration
      1. For Claude Desktop App
      2. For Claude VS Code Extension
    2. Available Tools
      1. open_note
      2. search_notes
      3. get_tags
      4. open_tag
    3. Example Usage
      1. Searching for Notes
      2. Opening a Specific Note
      3. Viewing Tags
      4. Finding Notes with a Specific Tag
    4. Advanced Options
      1. Technical Details
        1. Read-Only Implementation
      2. License
        ID: q04mrxtyp0