Bear Notes

Accede y gestiona tus notas desde la aplicación Bear.

GitHub
8
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Bear App

Un servidor de Model Context Protocol (MCP) que proporciona a Claude acceso a tus notas de Bear App. Busca, recupera y analiza tus notas de Bear directamente desde Claude Desktop o cualquier cliente compatible con MCP.

Características

🔍 Búsqueda y Descubrimiento

  • Búsqueda de texto completo en todas tus notas
  • Filtrado por etiquetas para contenido organizado
  • Búsqueda por título con coincidencia exacta o parcial
  • Notas recientes filtradas por fecha de modificación

💻 Código y Contenido Técnico

  • Buscador de manifiestos de Kubernetes - Localiza ejemplos de despliegues, configuraciones de servicios, etc.
  • Búsqueda de ejemplos de código - Encuentra fragmentos de código por lenguaje de programación
  • Extracción de bloques de código - Analiza y categoriza automáticamente bloques de código
  • Descubrimiento de documentación técnica

📊 Análisis de Contenido

  • Conteo de palabras y estadísticas de contenido
  • Detección de lenguaje de código desde bloques de código delimitados
  • Vistas previas de contenido para escaneo rápido
  • Extracción de metadatos (fechas de creación/modificación)

Instalación

Requisitos previos

  • macOS (Bear App es solo para macOS/iOS)
  • Bear App instalada y con algunas notas
  • Python 3.8 o superior
  • Claude Desktop (para integración de escritorio)

Pasos de configuración

  1. Clona o descarga el script del servidor

    git clone github.com/netologist/mcp-bear-notes

  2. Crea un entorno virtual

    uv install
source .venv/bin/activate

  3. Prueba el servidor

    uv run python main.py

Integración con Claude Desktop

Ubicación del archivo de configuración

Edita tu archivo de configuración de Claude Desktop:

~/Library/Application Support/Claude/claude_desktop_config.json

Agregar configuración del servidor MCP

{
  "mcpServers": {
    "bear-notes": {
      "command": "/full/path/to/mcp-bear-notes/.venv/bin/python",
      "args": ["/full/path/to/mcp-bear-notes/main.py"],
      "env": {
        "PYTHONPATH": "/full/path/to/mcp-bear-notes/.venv/lib/python3.13/site-packages"
      }
    }
  }
}

Importante: Reemplaza /full/path/to/ con tus rutas de archivo reales.

Reiniciar Claude Desktop

Cierra y vuelve a abrir Claude Desktop para cargar el servidor MCP.

Ejemplos de uso

Una vez integrado con Claude Desktop, puedes usar lenguaje natural para interactuar con tus notas de Bear:

Búsqueda básica

"Search my Bear notes for Docker examples"
"Find notes about Python APIs"
"Show me my recent notes from this week"

Contenido técnico

"Find my Kubernetes deployment manifests"
"Look for JavaScript code examples in my notes"
"Show me notes with YAML configurations"

Recuperación específica

"Get the note titled 'Development Setup'"
"Find notes tagged with 'work'"
"Show me all my available tags"

Herramientas disponibles

search_bear_notes(query, tag, limit)

Busca notas por contenido y etiquetas.

  • query: Texto a buscar
  • tag: Filtrar por etiqueta específica (sin #)
  • limit: Máximo de resultados (predeterminado: 20)

get_bear_note(note_id)

Recupera una nota específica por su ID único.

  • note_id: Identificador único de la nota de Bear

find_kubernetes_examples(resource_type)

Encuentra contenido relacionado con Kubernetes.

  • resource_type: Recurso de K8s (deployment, service, etc.)

find_code_examples(language, topic, limit)

Busca ejemplos de código.

  • language: Lenguaje de programación
  • topic: Tema/dominio del código
  • limit: Máximo de resultados (predeterminado: 15)

find_notes_by_title(title_query, exact_match)

Busca notas por título.

  • title_query: Texto del título a buscar
  • exact_match: Coincidencia exacta o parcial

get_recent_notes(days, limit)

Obtiene notas modificadas recientemente.

  • days: Cuántos días hacia atrás revisar (predeterminado: 7)
  • limit: Máximo de resultados (predeterminado: 20)

list_bear_tags()

Lista todas las etiquetas encontradas en tus notas.

Información de la base de datos de Bear

El servidor lee desde la base de datos SQLite de Bear ubicada en:

~/Library/Group Containers/9K33E3U3T4.net.shinyfrog.bear/Application Data/database.sqlite

Notas sobre acceso a la base de datos

  • Acceso de solo lectura - El servidor nunca modifica tus notas
  • No requiere autenticación - Usa acceso directo a SQLite
  • Rendimiento - Las consultas a la base de datos están optimizadas para velocidad
  • Seguridad - Solo accede a notas no eliminadas

Solución de problemas

Problemas comunes

El servidor no inicia

  • Verifica la ruta de Python en la configuración
  • Verifica la activación del entorno virtual
  • Asegúrate de que fastmcp esté instalado

No se encuentran notas

  • Verifica que la ruta de la base de datos de Bear exista
  • Comprueba que Bear App se haya abierto al menos una vez
  • Confirma que las notas no estén en la papelera

La integración con Claude Desktop falla

  • Valida la sintaxis JSON en el archivo de configuración
  • Comprueba que las rutas de archivo sean absolutas, no relativas
  • Reinicia Claude Desktop después de los cambios de configuración

Errores de permiso denegado

  • Asegúrate de que el script tenga permisos de ejecución: chmod +x main.py
  • Verifica los permisos del archivo de la base de datos de Bear

Modo de depuración

Ejecuta el servidor directamente para ver la salida de depuración:

python main.py

Archivos de registro

Revisa los registros de Claude Desktop para errores del servidor MCP:

~/Library/Logs/Claude/

Seguridad y privacidad

  • Solo local: Todos los datos permanecen en tu máquina
  • Solo lectura: El servidor nunca modifica tus notas
  • Sin red: No se requieren conexiones externas
  • Código abierto: Transparencia total de las operaciones

Contribuciones

¡Las contribuciones son bienvenidas! Áreas de mejora:

  • Filtros de búsqueda adicionales
  • Funcionalidad de exportación
  • Capacidades de creación de notas
  • Integración con Atajos de iOS
  • Optimizaciones de rendimiento

Licencia

Licencia MIT - Consulta el archivo LICENSE para más detalles.

Registro de cambios

v1.0.0

  • Lanzamiento inicial
  • Funciones básicas de búsqueda y recuperación
  • Buscadores de Kubernetes y ejemplos de código
  • Integración con Claude Desktop
  • Listado y filtrado de etiquetas

Soporte

Para problemas y preguntas:

  1. Consulta la sección de solución de problemas
  2. Revisa la documentación de MCP de Claude Desktop
  3. Abre un issue en GitHub
  4. Consulta los foros de Bear App para preguntas relacionadas con la base de datos

Nota: Esta es una herramienta no oficial y no está afiliada con Bear App ni Anthropic. Úsala bajo tu propio criterio.