Bear MCP Server

Bear MCP Server

Um servidor Model Context Protocol (MCP) que permite que assistentes de IA como o Claude leiam notas do aplicativo de anotações Bear. Esta implementação conecta-se diretamente ao banco de dados SQLite do Bear em modo somente leitura, garantindo que suas notas permaneçam seguras e inalteradas.

Início Rápido

Opção 1: Instalar a partir do GitHub (Recomendado)

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

É isso! O servidor começará a ser executado e se conectará ao seu banco de dados do Bear.

Opção 2: Clonar e Executar 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

Pré-requisitos

• macOS com o aplicativo Bear instalado
• Node.js 18 ou superior

Configuração

Para o aplicativo Claude Desktop

Adicione isto ao seu arquivo de configuração em ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Para a extensão Claude VS Code

Adicione isto ao seu arquivo de configuração em ~/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": []
    }
  }
}

Ferramentas Disponíveis

O servidor Bear MCP fornece estas ferramentas somente leitura (todas as operações são não destrutivas e não podem modificar seu banco de dados do Bear):

open_note

Abre uma nota por título ou ID.

search_notes

Pesquisa notas por termo ou tag.

get_tags

Obtém todas as tags no Bear.

open_tag

Mostra todas as notas com uma tag específica.

Exemplo de Uso

Aqui estão exemplos de como interagir com as ferramentas Bear MCP por meio de assistentes de IA:

Pesquisando Notas

Peça ao seu assistente de IA para pesquisar notas contendo termos específicos:

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

Abrindo uma Nota Específica

Peça ao seu assistente de IA para recuperar uma nota específica pelo título:

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

Visualizando Tags

Peça ao seu assistente de IA para listar todas as suas tags do Bear:

What tags do I have in my Bear notes?

Encontrando Notas com uma Tag Específica

Peça ao seu assistente de IA para mostrar notas com uma tag específica:

Show me all notes with the #work tag

Opções Avançadas

Se o seu banco de dados do Bear estiver em um local não padrão:

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

Detalhes Técnicos

Implementação Somente Leitura

Este servidor MCP conecta-se ao seu banco de dados SQLite do Bear usando uma conexão estritamente somente leitura. Isso é aplicado no nível do driver do banco de dados:

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

Isso garante que:

• Nenhuma operação de escrita pode ser realizada no seu banco de dados
• Suas notas e tags não podem ser modificadas, excluídas ou corrompidas
• A conexão com o banco de dados falhará se permissões de escrita forem tentadas

Todas as operações realizadas por este servidor são consultas SELECT que apenas recuperam dados sem modificá-los.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.