Servidor MCP de Segundo Cerebro

Un servidor MCP de solo lectura para un acceso inteligente y seguro a tu vault de Obsidian, permitiendo búsqueda semántica, filtrado de metadatos y más para LLMs.

Características

• Almacenamiento eficiente en base de datos: Indexación basada en SQLite para vaults grandes con caché persistente

• Modo de memoria opcional: Indexación en memoria opcional para vaults pequeños o desarrollo

• Búsqueda semántica: Búsqueda de texto completo en todas las notas con coincidencia difusa

• Filtrado basado en etiquetas: Búsqueda por etiquetas jerárquicas (ej. work/puppet, tech/golang)

• Filtrado basado en rutas: Filtrado por patrones de directorio (ej. Work/Puppet/**)

• Consultas temporales: Filtrado de notas por fechas de creación/modificación

• Filtrado de metadatos: Filtrado por tipo, estado y categoría

• Recuperación de notas: Obtención del contenido completo de notas específicas

• Resumen inteligente: Generación de resúmenes de colecciones de notas

• Notas recientes: Acceso rápido a notas modificadas recientemente

• Control de archivo: Inclusión opcional de notas archivadas en las búsquedas

• Brechas de conocimiento: Detección de wikilinks huérfanos y preguntas abiertas en todo el vault

• Revisión espaciada: Visualización de notas obsoletas clasificadas por la importancia de sus enlaces para revisión periódica

• Notas relacionadas: Descubrimiento basado en puntuación de notas relacionadas mediante enlaces compartidos, etiquetas y solapamiento de títulos

• Grafo del vault: Grafo completo de enlaces con detección de nodos principales, estadísticas de enlaces rotos y análisis de huérfanos

• Seguridad: Protección contra recorrido de rutas, límites de tamaño de archivo, validación de entrada

Related MCP server: Obsidian MCP Server

Compatibilidad del Vault

Este servidor funciona con cualquier directorio de archivos Markdown, no solo con vaults de Obsidian. Opera puramente en el sistema de archivos y no tiene dependencia de la aplicación Obsidian.

Uso con Foam

Apunta --vault-path a la raíz de tu espacio de trabajo de Foam. No se necesitan cambios de configuración:

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/foam-workspace"

Características de Foam que funcionan de inmediato:

• [[wikilinks]] y [[target|aliased links]] resueltos en herramientas de grafo

• Etiquetas de frontmatter YAML (tanto estilo [tag1, tag2] en línea como estilo lista de bloque)

• Jerarquías de etiquetas anidadas (work/backend)

• Estructura de subcarpetas (notes/, journal/, projects/)

• Notas sin frontmatter indexadas con valores predeterminados seguros

La carpeta .vscode/ se excluye automáticamente de la indexación.

Diseño de solo lectura

Este servidor MCP es intencionalmente de solo lectura para garantizar que tu vault permanezca seguro durante las interacciones con IA. Proporciona:

• ✅ Buscar y recuperar notas

• ✅ Filtrar por metadatos y rutas

• ✅ Generar resúmenes y estadísticas

• ❌ Sin creación ni edición de notas

• ❌ Sin modificaciones de archivos

Para operaciones de escritura, considera usar plugins de Obsidian dedicados con comprobaciones de seguridad integradas.

Instalación

Configuración e instalación

Instalación con un clic

• VS Code:

• VS Code Insiders:

• Cursor:

Instalación manual

¡No se necesita instalación! Úsalo directamente con npx:

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

Desarrollo local

cd second-brain-mcp
npm install
npm run build
npm link

Esto hace que el servidor esté disponible globalmente como second-brain-mcp.

Claude Code y Claude Desktop

Claude Code

Añade el servidor usando:

claude mcp add second-brain -- npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

Claude Desktop

Añade a tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/path/to/your/vault"
      ]
    }
  }
}

Consulta docs/configuration.md para ver la estructura del vault, argumentos de CLI y ejemplos de configuración.

Consulta docs/api.md para la referencia completa de la API de MCP y ejemplos de uso.

Uso con Claude Code

Añade a tu archivo de configuración de MCP.

Configuración de un solo vault

macOS/Linux: Edita ~/Library/Application Support/Claude/claude_desktop_config.json Windows: Edita %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/ioanniskarasavvaidis/Documents/Obsidian Vault"
      ]
    }
  }
}

Configuración de múltiples vaults

Puedes configurar múltiples instancias de vault:

{
  "mcpServers": {
    "second-brain-personal": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/username/Documents/Personal Vault"
      ]
    },
    "second-brain-work": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/username/Documents/Work Vault"
      ]
    }
  }
}

Configuración de desarrollo local

Si estás desarrollando localmente con npm link:

{
  "mcpServers": {
    "second-brain": {
      "command": "second-brain-mcp",
      "args": ["--vault-path", "/path/to/your/vault"]
    }
  }
}

Consulta docs/examples.md para más ejemplos de consultas.

Documentación

Consulta docs/README.md para:

• Referencia de API

• Opciones de configuración y CLI

• Ejemplos de consultas

• Arquitectura de desarrollo y almacenamiento

• Contribución

• Dependencias

• Arquitectura y esquema de base de datos

• Seguridad y búsqueda

• Ejemplos de consultas

• Desarrollo

• Contribución

• Dependencias

• Licencia

Inicio rápido

Ejecuta el servidor al instante con npx (no requiere instalación):

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

O añádelo a Claude Code/Claude Desktop (consulta Configuración e instalación a continuación).

Solución de problemas y preguntas frecuentes

Consulta docs/configuration.md para problemas comunes y soluciones.

Consulta docs/search.md para detalles sobre pesos de búsqueda y puntuación.

Consulta docs/security.md para detalles sobre características de seguridad y protecciones.

Consulta docs/development.md para el flujo de trabajo de desarrollo y detalles de almacenamiento.

Consulta docs/contributing.md para las directrices de contribución.

Arquitectura de almacenamiento

El servidor utiliza almacenamiento en base de datos SQLite por defecto para una indexación eficiente y caché persistente:

• Modo de base de datos (por defecto): Almacena notas indexadas en .second-brain-mcp/notes.db dentro de tu vault

  • Indexación persistente (sobrevive a reinicios del servidor)

  • Eficiente para vaults grandes (más de 1000 notas)

  • Búsqueda de texto completo con SQLite FTS5

  • Menor uso de memoria

• Modo de memoria (opcional): Usa el flag --use-memory para almacenamiento en memoria

  • Más rápido para vaults pequeños (menos de 100 notas)

  • Sin sobrecarga de E/S de disco

  • Útil para desarrollo y pruebas

  • Utiliza Fuse.js para búsqueda difusa

Consulta docs/architecture.md para el diagrama de arquitectura. Consulta docs/database-schema.md para el esquema de la base de datos.

Arquitectura

• src/index.ts: Implementación del servidor MCP con manejadores de herramientas

• src/vault.ts: Orquestación de indexación de vault y controles de seguridad

• src/storage.ts: Abstracción de interfaz de almacenamiento

• src/database-storage.ts: Implementación de almacenamiento basado en SQLite

• src/memory-storage.ts: Implementación de almacenamiento en memoria con Fuse.js

• src/storage-factory.ts: Patrón de fábrica de almacenamiento para selección de modo

• src/config.ts: Gestión de configuración con valores predeterminados

• src/types.ts: Definiciones de tipos de TypeScript y utilidades de validación

• src/__tests__/: Pruebas unitarias para funcionalidad crítica

Consulta docs/dependencies.md para una lista completa de dependencias de producción y desarrollo.

Soporte

Si second-brain-mcp te ahorra tiempo, considera patrocinarme en GitHub o invitarme a un café.

Licencia

MIT