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

Related MCP server: Filesystem MCP Server

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.