Memória básica: um serviço MCP para criar gráficos de conhecimento persistentes a partir de conversas de IA

Introdução geral

O Basic Memory é uma ferramenta para criar gráficos de conhecimento por meio do diálogo com assistentes de IA, como o Claude. Desenvolvido pela Basic Machines, seu principal recurso é salvar o conteúdo do diálogo como um arquivo Markdown, que é armazenado no computador local do usuário, garantindo que os dados estejam totalmente sob o controle do usuário. A ferramenta funciona da seguinte forma Modelo de protocolo de contexto (MCP) Colaborando com modelos grandes, a IA pode ler e gravar conhecimento para formar gráficos semanticamente conectados. Ele também oferece suporte à integração com o Obsidian para facilitar a visualização e a edição. Atualmente em versão beta, é adequado para usuários que precisam acumular conhecimento estruturado, como pesquisadores, escritores ou entusiastas da gestão do conhecimento.

Lista de funções

• O diálogo gera conhecimentoTransforme conversas naturais com IA em documentos Markdown estruturados.
• armazenamento localTodos os dados são salvos no computador do usuário e não são carregados na nuvem.
• mapeamento semânticoExtrai automaticamente as relações entre os pontos de conhecimento e gera gráficos percorríveis.
• Colaboração em modelos grandesProtocolo MCP: O protocolo MCP é usado para se comunicar com o Claude et al. modelam as interações para ler e escrever o conhecimento local.
• Integração da ObsidianVisualização e edição de arquivos Markdown diretamente na Obsidian.
• Importação de dadosSuporte para importação de diálogos existentes dos arquivos JSON do Claude.
• sincronização em tempo realMonitorar as alterações nos documentos para manter a base de conhecimento atualizada.

Usando a Ajuda

Processo de instalação

Atualmente, o Basic Memory é uma ferramenta de linha de comando e requer algumas habilidades técnicas para ser instalado. Veja a seguir as etapas detalhadas:

1. Preparação do ambiente
   • Certifique-se de que o Python 3.8 ou posterior esteja instalado em seu computador.
   • montagem uv (recomendada), execute-a no terminal:

     pip install uv
     

2. Instalação da memória básica
   • Digite o comando no terminal:

     uv tool install basic-memory
     

   • Verifique se a instalação foi bem-sucedida e execute-a:

     basic-memory --version
     

     Se o número da versão for exibido, a instalação estará concluída.

3. Configuração do servidor MCP
   • A memória básica se comunica com a IA por meio do protocolo MCP. Inicie o serviço MCP local:

     uvx basic-memory mcp
     

   • Se estiver usando o Claude, será necessário adicionar as configurações do MCP ao arquivo de configuração do Claude Desktop. Edite o arquivo (o caminho nos sistemas Mac é ~/Library/Application Support/Claude/claude_desktop_config.json):

     {
     "mcpServers": {
     "basic-memory": {
     "comando": "uvx".
     "args": ["basic-memory", "mcp"]
     }
     }
     }
     

4. Projeto de inicialização
   • Crie uma pasta como uma base de conhecimento, por exemplo. ~/memória básica.
   • Vá para a pasta:

     cd ~/basic-memory
     

   • Inicialização:

     inicialização da memória básica
     

5. Iniciar a sincronização
   • Execute o comando de sincronização em tempo real:

     memória básica sincronização --watch
     

Métodos alternativos de instalação (via Smithery)

• Use o Smithery para fazer a configuração automática:

npx -y @smithery/cli install @basicmachines-co/basic-memory --client claude

• Isso instala e configura automaticamente o Basic Memory, eliminando a necessidade de editar manualmente o arquivo de configuração do Claude.

Como usar os principais recursos

1. criação de conhecimento por meio do diálogo

• Abra o Claude Desktop e dialogue com a IA. Por exemplo, "Diga-me como preparar café".
• Quando a IA responde, o Basic Memory gera automaticamente um arquivo Markdown e o salva na pasta do seu projeto (por exemplo ~/memória básica). Exemplo de um documento:

---

título: Coffee-brewing-methods
permalink: coffee-brewing-methods
tipo: nota
tags: coffee-brewing-methods
- coffee-brewing-methods
- coffee-brewing-methods
---

# Método de preparo do café
## Observação
- MÉTODO] O café preparado manualmente tem um sabor mais delicado do que o da prensa francesa.
- Técnica] Temperatura da água de 96°C para melhor extração.
## Relações
- Relação [[fonte do grão de café]]
- Necessidades [[técnica de moagem]]

2. conhecimento de visualização e edição

• Abra a Obsidian e importe a pasta do projeto (por exemplo ~/memória básica).
• Visualize o Knowledge Graph na Obsidian e clique no arquivo para editá-lo. Por exemplo, se quiser adicionar "O soco na mão precisa de um filtro", você pode escrever isso diretamente no arquivo:

- [Ferramentas] O café preparado manualmente precisa de filtros

3. introdução de diálogos existentes

• Exporte os registros de diálogo no formato JSON do site do Claude.
• É executado no terminal:

basic-memory import --folder ~/basic-memory ~/Downloads/conversations.json

• O sistema converte o diálogo em um arquivo Markdown e o armazena na pasta especificada.

4. manter o conhecimento em sincronia

• estar em movimento sincronização de memória básica --watchO diálogo e a edição serão atualizados em tempo real.
• Por exemplo, depois que a Obsidian modifica um arquivo, a IA lê o conteúdo mais recente para o próximo diálogo.

Detalhes do processo de operação

• Iniciando um diálogoMarkdown: faça uma pergunta no Claude e a resposta será salva automaticamente como Markdown.
• Inspeção de documentosAbra a pasta do projeto para visualizar os arquivos gerados.
• Coleta de conhecimentoAjuste de conteúdo e adição de novos links na Obsidian.
• uso contínuoCada diálogo torna o gráfico de conhecimento mais completo.

A operação dessa ferramenta é intuitiva e todos os dados são locais. Depois de instalada, alguns comandos são suficientes para começar. Ela ainda está em desenvolvimento, mas a funcionalidade principal já é prática.

cenário do aplicativo

1. Gerenciamento de notas de pesquisa
   Os pesquisadores discutem tópicos com a IA e o Basic Memory gera automaticamente notas estruturadas para facilitar o acompanhamento.
2. Acumulação de material de escrita
   Os escritores conversam com a IA sobre inspiração, e a ferramenta registra e conecta o conteúdo relevante para apoiar a criação.
3. Criação de uma base de conhecimento pessoal
   Os usuários fazem perguntas diárias à IA, como dicas de culinária, construindo gradualmente uma base de conhecimento pessoal.

QA

1. Preciso fazer networking?
   Sim, a comunicação com a IA requer uma rede, mas os dados são armazenados apenas localmente.
2. Quais são os modelos suportados?
   O Claude é suportado no momento; outros modelos poderão ser adicionados no futuro.
3. Os dados serão perdidos?
   Não, a menos que o usuário o exclua manualmente, os arquivos estarão sob controle local.