
Bovedia
io.github.jmpdsevilla由 GitHub 帳號 jmpdsevilla 發布v2.7.0更新於 Oct 24, 2026
Memoria personal para Claude Code en notas Markdown; no carga el contexto a ciegas.
概覽
Bovedia 為 AI 助理提供持久化的個人記憶,內容以純 Markdown 筆記保存在本機筆記庫中,只依需求載入目前任務所需的部分。
- 可以做什麼
- 在 Markdown 筆記庫中建立、讀取、搜尋、列出和刪除筆記與分類,提供筆記庫結構索引,並在移動或重新命名時自動更新 wikilink。就地編輯筆記:尋找取代、在開頭或結尾附加內容、取代或插入整節、更新 YAML frontmatter。低成本讀取:查看 frontmatter 與首段、只讀某一節、列出標題、只讀 frontmatter。維護連結與標籤:尋找失效 wikilink、反向連結和孤立筆記,全庫重新命名 wikilink,列出與稽核標籤、合併標籤變體。筆記庫維護:最近更新、到期排程筆記、驗證、批次移動、健康報告,以及建立、列出和還原快照。
- 適用情境
- 當你希望助理在多次工作階段之間保留持久記憶,且記憶存放在自己擁有、可用任何文字編輯器修改的筆記中,而不是每次重新載入全部上下文時使用。適合用 Markdown 資料夾整理專案、客戶和參考資料的人,可選擇透過 iCloud、OneDrive、Google Drive 或 Dropbox 同步。
- 執行需求
- 透過 npx 或複製儲存庫以 stdio 在本機執行;需要 Node.js 18 或以上版本,以及 Claude Code 等 MCP 用戶端。用環境變數 KB_MEMORY_ROOT 指向筆記庫(預設 ~/Documents/bovedia)。選用:KB_TOOLS=core 只暴露日常工具,KB_ENABLE_ANNOTATIONS=1 啟用署名工具,KB_AUTHOR_NAME 與 KB_AUTHOR_EMAIL 設定簽名。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Bovedia,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
BovedIA
Memoria personal para Claude Code: tus notas en Markdown, tuyas y para siempre.
[Node.js] [License: MIT] [MCP Compatible]
Estado del proyecto (28 de agosto de 2026). BovedIA se sigue desarrollando a diario, pero en un repositorio privado: el trabajo del día a día se hace sobre una instalación real y sus pruebas contienen datos de clientes y agenda personal, así que publicarlo tal cual no es una opción responsable.
Lo que hay aquí es una versión estable, completa y probada (v2.8.1, 89 pruebas): funciona, se mantiene instalable y su licencia MIT no cambia. No está abandonada — está congelada a propósito.
Cuando haya material que pueda salir limpio (el módulo de agenda para Apple, la memoria por activación, la búsqueda semántica local), se publicará aquí. Sin fecha comprometida.
Qué es BovedIA
BovedIA (bóveda + IA) es un servidor MCP que le da a Claude Code —y a cualquier cliente MCP— memoria persistente. Tus notas viven en archivos Markdown planos, en tu disco, sincronizados en la nube si quieres. La IA puede leerlas, crearlas, buscarlas y organizarlas durante cualquier sesión de trabajo.
Pero BovedIA no es solo el motor. Es también una forma de organizar la memoria para que la IA llegue a cada conversación ligera y enfocada, en vez de arrastrar todo el contexto de golpe. Esa forma va incluida en el vault-example/ de este repositorio, lista para adaptar.
La idea de fondo: no cargar todo de golpe
Casi todos los sistemas de memoria vuelcan todo el contexto en cada sesión. BovedIA parte de lo contrario: traer solo lo que el caso pide, en el momento en que lo pide. Cargar de más no es solo trabajo desperdiciado — condiciona y ensucia la respuesta.
Para lograrlo, la bóveda se recorre por niveles (la pirámide):
- El router (
Inicio). La única nota que se lee siempre, al empezar cada conversación. No contiene el trabajo: contiene el criterio para decidir qué cargar y cuándo. Si la señal es clara, la IA actúa; si no, pregunta. - Las portadas de rama. Cada gran área (proyectos, clientes, infraestructura…) tiene una portada que el router carga solo cuando el tema entra por ahí.
- Las notas. El contenido real, al que se llega desde su portada o por búsqueda.
Y una capa aparte, el alma: la carpeta donde se vuelca lo que uno piensa y siente — el porqué de fondo, la mentalidad, la manera de mirar el trabajo. No es documentación: es lo que hace que la memoria deje de ser un archivador y empiece a ser continuidad.
Por qué así
- Simple: un solo archivo de servidor (
index.js), una sola dependencia. - Tuyo: las notas son archivos
.mden tu disco — sin bases de datos, sin APIs externas. - Portátil: funciona con iCloud, OneDrive, Google Drive, Dropbox o cualquier carpeta local.
- Transparente: abres y editas tus notas en cualquier editor de texto.
La estructura de la bóveda: para qué sirve cada carpeta
El vault-example/ trae una estructura de referencia lista para usar. No es una jaula: crea las categorías que tu trabajo pida. Pero enseña el método completo.
Instalación
Opción rápida: npx
No necesitas clonar nada. Añade esto a la configuración MCP de tu cliente (Claude Code, Claude Desktop…) y copia el vault-example/ a tu carpeta como punto de partida:
El resto de esta sección es la instalación manual (clonando el repo), útil si quieres modificar el código.
Requisitos
- Node.js 18 o superior
- Claude Code (
npm install -g @anthropic-ai/claude-code) - Una carpeta sincronizada en la nube (iCloud, OneDrive, Google Drive, Dropbox) — o cualquier carpeta local
1. Clonar el repositorio
2. Crear tu bóveda
Copia la bóveda de ejemplo a tu carpeta sincronizada y personaliza HOME.md e Inicio.md:
3. Configurar Claude Code
Apunta el servidor a tu bóveda con la variable KB_MEMORY_ROOT (acepta rutas con ~):
Si no defines KB_MEMORY_ROOT (ni su alias MEMORY_PATH), BovedIA usa ~/Documents/bovedia por defecto.
4. Verificar
Reinicia Claude Code y pide leer Inicio, o ejecutar get_index. Deberías ver tu bóveda.
Anotaciones de autoría (opcional)
BovedIA soporta opcionalmente Markdown Annotations, una spec abierta originalmente de iA Writer que registra qué autor escribió qué parte de cada nota. Cuando se activa, las notas escritas por la IA llevan al final un bloque que atribuye el cuerpo a &Claude; cuando un humano edita la nota en un editor compatible, sus rangos quedan marcados como @nombre, y la siguiente vez que BovedIA toque la nota preserva esa autoría en vez de sobrescribirla.
Está desactivado por defecto. Para activarlo, añade KB_ENABLE_ANNOTATIONS=1 al entorno del servidor:
Con la opción activa se desbloquean dos herramientas: read_authorship (resumen de quién escribió qué) y migrate_annotations (añade el bloque a todas las notas existentes; ejecútala con dry_run: true primero). La firma se puede personalizar con KB_AUTHOR_NAME y KB_AUTHOR_EMAIL.
Solo actívalo si usas un editor compatible con la spec: los que no la soportan mostrarán el bloque como texto plano al final del archivo.
Las herramientas
38 en total. Las 36 primeras funcionan siempre. Las 2 de autoría (read_authorship, migrate_annotations) solo se exponen si arrancas el servidor con KB_ENABLE_ANNOTATIONS=1.
El listado de herramientas viaja en cada sesión y ocupa contexto. Si tu cliente tiene poca ventana, arranca con KB_TOOLS=core y se expondrán solo las 15 de uso diario (la mitad de tokens). Por defecto se exponen todas.
Lectura y escritura base
Edición dirigida
Mantenimiento de wikilinks y tags
Lecturas baratas
Mantenimiento de la bóveda
Autoría (con KB_ENABLE_ANNOTATIONS=1)
Referencia completa en docs/tools-reference.md.
Protocolo de uso
Añade esta instrucción a tu CLAUDE.md o a la configuración del asistente para sacarle todo el partido:
Wikilinks
Las notas se enlazan entre sí con el formato [[slug]]:
Reglas:
- Usa el slug del nombre de archivo (kebab-case, sin
.md). - Sin rutas:
→[[referencias/x]][[x]]. - Sin alias:
→[[x|otro texto]][[x]].
Cuando una nota se renombra, sus wikilinks se actualizan automáticamente.
Guías de instalación detalladas
Autor
Creado por José Manuel Pérez, fundador de santa marta crea — agencia digital. Santa Marta, Colombia.
- Web: santamartacrea.com
- GitHub: @jmpdsevilla
Licencia
MIT — libre para usar, modificar y distribuir.
來源:README.md,提交 0be2d35
工具
0版本歷史
1- v2.7.0最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分