Bear

Um servidor para interagir com o aplicativo de anotações Bear.

Documentação

[!NOTE] Este repositório está arquivado. A partir da v2.8, o Bear agora inclui uma implementação nativa de servidor MCP, tornando este servidor independente desnecessário.

Servidor MCP do Bear

uv Python Application pre-commit GitHub License

Um servidor MCP para interagir com o software de anotações Bear.

Bear MCP Server Icon

Instalação

[!NOTE] Você precisará ter o uv instalado no seu sistema para usar o comando uvx.

goose

Abra este link

goose://extension?cmd=uvx&arg=--from&arg=git%2Bhttps%3A%2F%2Fgithub.com%2Fjkawamoto%2Fmcp-bear&arg=mcp-bear&id=bear&name=Bear&description=Interacting%20with%20Bear%20note-taking%20software&env=BEAR_API_TOKEN

para iniciar o instalador e, em seguida, clique em "Sim" para confirmar a instalação. Defina a variável de ambiente BEAR_API_TOKEN para o seu token de API.

Configuração manual

Você também pode editar diretamente o arquivo de configuração (~/.config/goose/config.yaml) para incluir a seguinte entrada:

extensions:
  bear:
    name: Bear
    cmd: uvx
    args: [--from, git+https://github.com/jkawamoto/mcp-bear, mcp-bear]
    envs: { "BEAR_API_TOKEN": "<YOUR_TOKEN>" }
    enabled: true
    type: stdio

Para mais detalhes sobre como configurar servidores MCP no Goose, consulte a documentação: Usando Extensões | goose.

Claude

Baixe o pacote MCP mais recente mcp-bear.mcpb da página de Releases, e então abra o arquivo .mcpb baixado ou arraste-o para a janela de Configurações do Claude Desktop.

Configuração manual

Você também pode configurar manualmente este servidor para o Claude Desktop. Edite o arquivo claude_desktop_config.json adicionando a seguinte entrada sob mcpServers:

{
  "mcpServers": {
    "bear": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-bear",
        "mcp-bear",
        "--token",
        "<YOUR_TOKEN>"
      ]
    }
  }
}

Após a edição, reinicie o aplicativo.

Para mais informações, veja: Conecte-se a servidores MCP locais - Model Context Protocol.

LM Studio

Para configurar este servidor para o LM Studio, clique no botão abaixo.

Add MCP Server bear to LM Studio

Ações Implementadas

O servidor suporta as seguintes ações. Consulte a documentação do esquema X-callback-url do Bear para detalhes sobre cada ação.

  • /open-note
  • /create
  • /add-text (parcialmente, via o método replace_note e add_title)
  • /add-file
  • /tags
  • /open-tag
  • /rename-tag
  • /delete-tag
  • /trash
  • /archive
  • /untagged
  • /todo
  • /today
  • /locked
  • /search
  • /grab-url

Licença

Este aplicativo é licenciado sob a Licença MIT. Consulte o arquivo LICENSE para mais detalhes.