Bear Notes

Acesse e gerencie suas notas do Bear App.

Documentação

Servidor MCP do Bear App

Um servidor Model Context Protocol (MCP) que fornece ao Claude acesso às suas notas do Bear App. Pesquise, recupere e analise suas notas do Bear diretamente do Claude Desktop ou de qualquer cliente compatível com MCP.

Recursos

🔍 Pesquisa e Descoberta

Pesquisa de texto completo em todas as suas notas
Filtro por tags para conteúdo organizado
Pesquisa por título com correspondência exata ou parcial
Notas recentes com filtro por data de modificação

💻 Código e Conteúdo Técnico

Localizador de manifestos Kubernetes - Encontre exemplos de deployments, configurações de serviços, etc.
Pesquisa de exemplos de código - Encontre trechos de código por linguagem de programação
Extração de blocos de código - Analise e categorize blocos de código automaticamente
Descoberta de documentação técnica

📊 Análise de Conteúdo

Contagem de palavras e estatísticas de conteúdo
Detecção de linguagem de código em blocos de código cercados
Pré-visualizações de conteúdo para leitura rápida
Extração de metadados (datas de criação/modificação)

Instalação

Pré-requisitos

macOS (o Bear App é exclusivo para macOS/iOS)
Bear App instalado e com algumas notas
Python 3.8 ou superior
Claude Desktop (para integração com desktop)

Etapas de Configuração

Clone ou baixe o script do servidor

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

Crie um ambiente virtual
```
uv install
source .venv/bin/activate
```
Teste o servidor
```
uv run python main.py
```

Integração com Claude Desktop

Localização do Arquivo de Configuração

Edite o arquivo de configuração do Claude Desktop:

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

Adicione a Configuração do 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: Substitua /full/path/to/ pelos seus caminhos de arquivo reais.

Reinicie o Claude Desktop

Feche e reabra o Claude Desktop para carregar o servidor MCP.

Exemplos de Uso

Depois de integrado ao Claude Desktop, você pode usar linguagem natural para interagir com suas notas do Bear:

Pesquisa Básica

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

Conteúdo Técnico

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

Recuperação Específica

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

Ferramentas Disponíveis

`search_bear_notes(query, tag, limit)`

Pesquise notas por conteúdo e tags.

query: Texto para pesquisar
tag: Filtrar por tag específica (sem #)
limit: Máximo de resultados (padrão: 20)

`get_bear_note(note_id)`

Recupere uma nota específica pelo seu ID único.

note_id: Identificador único da nota do Bear

`find_kubernetes_examples(resource_type)`

Encontre conteúdo relacionado a Kubernetes.

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

`find_code_examples(language, topic, limit)`

Pesquise exemplos de código.

language: Linguagem de programação
topic: Tópico/domínio do código
limit: Máximo de resultados (padrão: 15)

`find_notes_by_title(title_query, exact_match)`

Pesquise notas por título.

title_query: Texto do título para pesquisar
exact_match: Correspondência exata ou parcial

`get_recent_notes(days, limit)`

Obtenha notas modificadas recentemente.

days: Quantos dias para olhar para trás (padrão: 7)
limit: Máximo de resultados (padrão: 20)

`list_bear_tags()`

Liste todas as tags encontradas nas suas notas.

Informações do Banco de Dados do Bear

O servidor lê do banco de dados SQLite do Bear localizado em:

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

Notas sobre Acesso ao Banco de Dados

Acesso somente leitura - O servidor nunca modifica suas notas
Nenhuma autenticação necessária - Usa acesso direto ao SQLite
Desempenho - As consultas ao banco de dados são otimizadas para velocidade
Segurança - Acessa apenas notas que não estão na lixeira

Solução de Problemas

Problemas Comuns

O servidor não inicia

Verifique o caminho do Python na configuração
Verifique a ativação do ambiente virtual
Certifique-se de que o fastmcp está instalado

Nenhuma nota encontrada

Verifique se o caminho do banco de dados do Bear existe
Verifique se o Bear App foi aberto pelo menos uma vez
Confirme que as notas não estão na lixeira

A integração com Claude Desktop falha

Valide a sintaxe JSON no arquivo de configuração
Verifique se os caminhos de arquivo são absolutos, não relativos
Reinicie o Claude Desktop após alterações na configuração

Erros de permissão negada

Certifique-se de que o script tem permissões de execução: chmod +x main.py
Verifique as permissões do arquivo do banco de dados do Bear

Modo de Depuração

Execute o servidor diretamente para ver a saída de depuração:

python main.py

Arquivos de Log

Verifique os logs do Claude Desktop para erros do servidor MCP:

~/Library/Logs/Claude/

Segurança e Privacidade

Somente local: Todos os dados permanecem na sua máquina
Somente leitura: O servidor nunca modifica suas notas
Sem rede: Nenhuma conexão externa necessária
Código aberto: Transparência total das operações

Contribuindo

Contribuições são bem-vindas! Áreas para melhoria:

Filtros de pesquisa adicionais
Funcionalidade de exportação
Capacidades de criação de notas
Integração com iOS Shortcuts
Otimizações de desempenho

Licença

Licença MIT - Consulte o arquivo LICENSE para detalhes.

Histórico de Alterações

v1.0.0

Lançamento inicial
Funções básicas de pesquisa e recuperação
Localizadores de Kubernetes e exemplos de código
Integração com Claude Desktop
Listagem e filtro de tags

Suporte

Para problemas e dúvidas:

Consulte a seção de solução de problemas
Revise a documentação MCP do Claude Desktop
Abra uma issue no GitHub
Consulte os fóruns do Bear App para perguntas relacionadas ao banco de dados

Nota: Esta é uma ferramenta não oficial e não é afiliada ao Bear App ou à Anthropic. Use por sua conta e risco.