Bear MCP Server

Bear MCP Server

Un servidor de Model Context Protocol (MCP) que permite a asistentes de IA como Claude leer notas de la aplicación de toma de notas Bear. Esta implementación se conecta directamente a la base de datos SQLite de Bear en modo de solo lectura, garantizando que tus notas permanezcan seguras y sin modificaciones.

Inicio Rápido

Opción 1: Instalar desde GitHub (Recomendado)

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

¡Eso es todo! El servidor comenzará a ejecutarse 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

Requisitos previos

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

Configuración

Para la aplicación de escritorio de Claude

Añade esto a tu 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 de Claude VS Code

Añade esto a tu 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 tu base de datos de Bear):

open_note

Abre una nota por título o ID.

search_notes

Busca notas por término o etiqueta.

get_tags

Obtén todas las etiquetas en Bear.

open_tag

Muestra todas las notas con una etiqueta específica.

Ejemplos de uso

Aquí hay ejemplos de cómo interactuar con las herramientas Bear MCP a través de asistentes de IA:

Buscar notas

Pide a tu 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

Pide a tu asistente de IA que recupere una nota específica por título:

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

Ver etiquetas

Pide a tu asistente de IA que liste todas tus etiquetas de Bear:

What tags do I have in my Bear notes?

Encontrar notas con una etiqueta específica

Pide a tu asistente de IA que muestre notas con una etiqueta particular:

Show me all notes with the #work tag

Opciones avanzadas

Si tu base de datos de 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 tu base de datos SQLite de Bear utilizando una conexión estricta de solo lectura. 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 puedan realizar operaciones de escritura en tu base de datos
• Tus notas y etiquetas no puedan ser modificadas, eliminadas o corrompidas
• 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 - consulta el archivo LICENSE para más detalles.