convez.ai
MCP ServerAutomaçãoIntermediário
Vahlame

Obsidian Memory Kit

Vahlame/obsidian-memory-kit

Memória persistente para agentes IA com Markdown + Git via MCP

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que fornece memória persistente e cross-device para agentes de IA, usando um vault Markdown sincronizado via Git. O agente lê e escreve notas através do protocolo MCP, mantendo tudo local e sob seu controle, sem dependência de serviços em nuvem.

Instalação

$npx convez-ai Vahlame/obsidian-memory-kit

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 2 semanas
Versão
v5.7.0
Issues abertas
12
Contribuidores
2

Casos de uso

  • Agentes IA (Claude, Cursor) que precisam manter contexto entre sessões
  • Automação de documentação e anotações estruturadas
  • Sincronização de conhecimento entre múltiplos dispositivos via Git

Veredito

Solução técnica robusta que resolve um problema real: persistência de memória para agentes IA sem infraestrutura em nuvem. Implementação bem pensada com MCP, suporte multiplataforma e opções de busca semântica, embora exija conhecimento técnico para setup completo.

README

A tradução para o português deste README ainda está na fila.


¿Qué es esto? · What is this?

🇪🇸 Un kit multiplataforma que le da a la IA (Cursor, Claude Code…) una memoria que sobrevive entre chats: una carpeta de notas Markdown bajo git que el agente lee y escribe a través de MCP (el puente entre el editor y tus archivos). Sin servicio en la nube. La pieza obligatoria es solo el servidor MCP; lo demás (búsqueda semántica, daemon de sync) es opcional.

🇬🇧 A cross-platform kit that gives your AI (Cursor, Claude Code…) memory that survives across chats: a folder of Markdown notes under git that the agent reads and writes through MCP (the bridge between the editor and your files). No cloud service. The only required piece is the MCP server; everything else (semantic search, sync daemon) is optional.

¿Cómo fluye la información? El diagrama de arriba lo resume; el detalle visual está en Cómo funciona · How it works.


Instalación rápida · Quick install

Un comando conecta tu editor a un vault (lo crea si no existe, fusiona mcp.json sin romper otras entradas, hace backup). Sin parámetros = asistente interactivo; con -y no pregunta nada:

npx @vkmikc/create-obsidian-memory                 # asistente interactivo (pre-marca Codex + Claude)
npx @vkmikc/create-obsidian-memory -y              # sin preguntas → ~/Documents/obsidian-memory-vault
npx @vkmikc/create-obsidian-memory "<RUTA>" -y     # sin preguntas, en la ruta que elijas

⚡ Todo su potencial, en un solo comando · the whole stack in one command — --full. Enfocado primero en Codex y Claude Code: registra el MCP en ambos, activa búsqueda híbrida (BM25 + semántica), instala el backend Python, construye el índice e instala las reglas — sin preguntas. Córrelo desde un clon del kit (o pásale --repo-root <clon>):

npx @vkmikc/create-obsidian-memory --full          # = --ide codex,claude --with-hybrid --semantic --build-index --install-backend --rules

Si no hay clon a mano, --full no aborta: cae a basic-memory (sin híbrido) y avisa.

¿Prefieres que un agente lo instale? Clónalo y dile «instálalo»: que ejecute npm install y npm run setup — preflight de dependencias → instalación --full → verificación → aviso de reinicio. · Prefer an agent to do it? Clone it and have it run npm install then npm run setup.

🤖 Claude Code / Codex (PC nuevo · fresh PC): --full ya registra el MCP vía claude mcp add / codex mcp add y construye el índice en el mismo comando. ¿Solo lo básico? usa --ide codex,claude. Guía completa: 🇪🇸 instalar en PC nueva · 🇬🇧 fresh-PC install.

Luego pega las User Rules y verifica. Los pasos completos (y la verificación) están en la guía:

🇪🇸 Guía de instalación →

o deja que un agente lo instale

🇬🇧 Install guide →

or let an agent install it


Qué incluye · What's inside

Pieza · PieceLenguajeRol
packages/create-obsidian-memory/NodeInstalador npx (npm): fusiona el MCP y crea el vault.
packages/obsidian-memory-mcp/NodeMCP "híbrido" (privado; corre desde el clon): tools del vault + búsqueda léxica/semántica.
packages/obsidian-memory-rag/PythonMotor de búsqueda FTS5/BM25 + vectorial (pip install -e desde el código); cero dependencias por defecto.
cmd/obsidian-memoryd/GoDaemon opcional: vigila el vault y sincroniza git.

Mapa técnico completo y diagramas de flujo: ARCHITECTURE.md. El porqué de cada decisión: docs/adr/.


Más · More

Licencia · License

MIT — ver LICENSE.

Ver o original no GitHub

Bom para

Relacionados