Construindo um Espaço de Trabalho Local com MCP e RAG Híbrido

O problema

Como muitos desenvolvedores, eu vivo em várias superfícies ao mesmo tempo: um editor, um terminal, notas, listas de tarefas e um assistente de IA. Cada um é bom por si só. Juntos, eles são horríveis em uma coisa: manter uma única e confiável fatia de contexto do projeto sincronizada.

Eu estava cansado de:

• Reexplicar o mesmo contexto para Claude
• Copiar e colar trechos de notas ou contexto do repositório
• “Saber” que algo estava em algum documento ou ticket, mas não conseguir extrair a passagem exata quando eu precisava

Eu queria um lugar local para espaço de trabalho + conhecimento, mas também queria que esses dados estivessem em toda parte no meu Mac—não presos em um único aplicativo.

O que eu construí

DeepThink é um espaço de trabalho local-primeiro para macOS: projetos, notas, tarefas, lembretes e uma base de conhecimento pessoal, com uma interface nativa em SwiftUI para que você possa realmente navegar e editar seus dados como um aplicativo de verdade.

Além disso, ele inclui:

• Um servidor MCP para que clientes compatíveis com MCP possam ler e atualizar o que o aplicativo gerencia
• Um deepthink CLI para fluxos de trabalho no terminal
• Hybrid RAG (recuperação por palavra-chave + semântica) para que assistentes possam anexar trechos precisos em vez de diretórios inteiros

A persistência está na sua máquina (SwiftData mais markdown em disco e embeddings sob ~/DeepThink/). O objetivo não é “outro aplicativo de notas”—é um espaço de trabalho que outras ferramentas podem ver e reutilizar através de MCP e CLI, com uma GUI quando você quiser pensar em telas em vez de prompts.

Por que MCP + CLI são importantes

MCP é a diferença entre “meus dados vivem em um aplicativo” e “meus dados são uma capacidade que meu editor e agentes podem chamar.” Se seu assistente pode consultar seu espaço de trabalho da mesma forma que sua interface faz, você para de tratar a IA como um silo separado e começa a tratá-la como outro cliente sobre a mesma fonte de verdade.

O CLI cobre os casos em que você não está em um cliente ciente de MCP: scripts, fluxos semelhantes ao SSH, capturas rápidas ou “apenas me dê contexto para esta consulta” a partir do shell.

Juntos, eles são como eu obtenho dados locais para o resto da minha máquina sem transformar copiar e colar em um segundo trabalho.

Hybrid RAG (e por que “somente semântico” não era suficiente)

Despejar grandes pastas no Claude “funciona” até que não funcione: você consome tokens, dilui o sinal e o modelo ainda pode perder o único parágrafo que importava.

DeepThink usa recuperação híbrida: busca por palavra-chave estilo BM25 mais busca semântica (na pilha de embeddings da Apple via NLEmbedding). Na prática, isso significa:

• Símbolos exatos, nomes de arquivos e termos raros ainda aparecem por meio de correspondência lexical
• Paráfrases e “não consigo lembrar a redação” consultas ainda aparecem por meio de correspondência semântica
• Você pode fundamentar o assistente nas passagens que você quer dizer, não no feno inteiro

Essa é a mesma ideia subjacente ao bom RAG em sistemas de produção: recuperar estreito, gerar amplo.

Claude no loop

A IA conversacional passa pelo Claude CLI da Anthropic (claude login) ao lado dessa camada de recuperação. O objetivo não é substituir seu editor; é tornar conversas conscientes do espaço de trabalho baratas o suficiente para usar o dia todo porque você não está reenviando o mundo a cada turno.

Há também um caminho de comando /deepthink no fluxo de trabalho para que ações comuns permaneçam rápidas uma vez que você esteja configurado.

Para quem isso é

Você pode se interessar se você:

• Quer controle local-primeiro sobre notas, tarefas e conhecimento
• Usa Claude e quer MCP como a ponte para um espaço de trabalho real
• Prefere uma interface nativa do macOS para navegar e editar, não apenas chat

Você provavelmente não precisa disso se estiver feliz com um único silo SaaS e não se importar com armazenamento local ou integração MCP.

Obtenha o DeepThink

• Tente: try-deepthink.vercel.app
• Repo: deepthink
• Aplicativo para Mac: v1.0.0 release (A instalação completa e solução de problemas estão nessa página de lançamento.)

Feedback e PRs são bem-vindos, especialmente sobre MCP, recuperação e o CLI.