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.

Servidor Bear MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a asistentes de IA como Claude leer notas de la aplicación de notas Bear . Esta implementación se conecta directamente a la base de datos SQLite de Bear en modo de solo lectura, lo que garantiza que sus notas permanezcan seguras y sin modificaciones.

Inicio rápido

Opción 1: Instalar desde GitHub (recomendado)

npx github:bart6114/my-bear-mcp-server

¡Listo! El servidor se iniciará y se conectará a tu base de datos de Bear.

Opción 2: Clonar y ejecutar localmente

# 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

Prerrequisitos

  • macOS con la aplicación Bear instalada
  • Node.js 18 o superior

Configuración

Para la aplicación de escritorio de Claude

Agregue esto a su archivo de configuración en ~/Library/Application Support/Claude/claude_desktop_config.json :

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

Para la extensión Claude VS Code

Agregue esto a su archivo de configuración en ~/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": [] } } }

Herramientas disponibles

El servidor Bear MCP proporciona estas herramientas de solo lectura (todas las operaciones son no destructivas y no pueden modificar su base de datos Bear):

nota abierta

Abrir una nota por título o ID.

notas de búsqueda

Busque notas por término o etiqueta.

obtener_etiquetas

Obtenga todas las etiquetas en Bear.

etiqueta abierta

Mostrar todas las notas con una etiqueta específica.

Ejemplo de uso

A continuación se muestran ejemplos de cómo interactuar con las herramientas Bear MCP a través de asistentes de IA:

Buscando notas

Pídale a su asistente de IA que busque notas que contengan términos específicos:

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

Abrir una nota específica

Pídale a su asistente de IA que recupere una nota específica por título:

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

Visualización de etiquetas

Pídele a tu asistente de IA que enumere todas tus etiquetas de Bear:

What tags do I have in my Bear notes?

Cómo encontrar notas con una etiqueta específica

Pídale a su asistente de IA que muestre notas con una etiqueta particular:

Show me all notes with the #work tag

Opciones avanzadas

Si su base de datos Bear está en una ubicación no estándar:

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

Detalles técnicos

Implementación de solo lectura

Este servidor MCP se conecta a su base de datos Bear SQLite mediante una conexión de solo lectura estricta. Esto se aplica a nivel del controlador de la base de datos:

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

Esto garantiza que:

  • No se pueden realizar operaciones de escritura en su base de datos
  • Sus notas y etiquetas no se pueden modificar, eliminar ni corromper.
  • La conexión a la base de datos fallará si se intentan permisos de escritura

Todas las operaciones realizadas por este servidor son consultas SELECT que solo recuperan datos sin modificarlos.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

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

Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA como Claude leer notas de la aplicación de toma de notas Bear en un modo seguro y de solo lectura.

  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