Obsidian Nexus

Obsidian Nexus - Servidor MCP de Obsidian

Conecta Claude Desktop directamente a tu bóveda de Obsidian para una gestión de notas fluida y una organización inteligente de datos familiares.

Resumen

Obsidian Nexus es un servidor de Protocolo de Contexto de Modelo (MCP) que le da a Claude Desktop acceso directo a tu bóveda de Obsidian. Simplemente configura la ruta de tu bóveda y comienza a gestionar las notas, tareas y base de conocimiento de tu familia mediante conversación natural con Claude.

Características Principales

📝 Acceso Directo a la Bóveda

• Lee, escribe y añade contenido a cualquier nota de tu bóveda
• Creación y organización automática de carpetas
• Soporte completo de Markdown con enlaces de Obsidian

🔍 Búsqueda Inteligente

• Busca en todas las notas con extractos contextuales
• Lista notas por directorio o patrón
• Encuentra información al instante mediante consultas naturales

🏠 Organización Familiar

• Estructura de carpetas preconfigurada para datos familiares
• Soporte para Notas Diarias, miembros de la familia y Temas
• Cero configuración: solo apunta a tu bóveda

🛡️ Simple y Confiable

• No se requieren claves API: Claude Desktop realiza el procesamiento de IA
• Operaciones de archivo solo locales para privacidad
• Creación automática de la estructura de la bóveda

Inicio Rápido

1. Instalación

git clone https://github.com/nkriman/obsidian-nexus
cd obsidian-nexus
npm install

2. Configuración

Edita config.yaml y establece la ruta de tu bóveda:

# Update this path to your Obsidian vault
vault_path: "/Users/yourname/Documents/Obsidian/YourVault"

# Optional: Configure family members
family:
  people: ["Nick", "Sarah", "Leo", "Mia"]

3. Añadir a Claude Desktop

Añade a tu configuración de MCP (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "obsidian-nexus": {
      "command": "node",
      "args": ["/path/to/obsidian-nexus/src/index.js"]
    }
  }
}

4. Reinicia Claude Desktop

¡Eso es todo! Claude ahora puede acceder a tu bóveda de Obsidian.

Herramientas Disponibles

📖 read_note

Lee cualquier nota de tu bóveda:

read_note path="Family/Leo.md"

✏️ write_note

Crea o actualiza una nota:

write_note path="Daily Notes/2025-06-22.md" content="# Today's Activities..."

➕ append_to_note

Añade contenido a una nota existente:

append_to_note path="Family/Leo.md" content="## School Update\nGot an A on math test!"

📚 list_notes

Lista todas las notas o busca por directorio:

list_notes directory="Family"

🔍 search_notes

Busca contenido en toda tu bóveda:

search_notes query="doctor appointment"

📊 vault_status

Comprueba la configuración y estadísticas de la bóveda.

Estructura de la Bóveda

Obsidian Nexus crea automáticamente esta estructura organizada:

YourVault/
├── Daily Notes/
│   └── 2025-06-22.md          # Daily family logs
├── Family/
│   ├── Leo.md                 # Individual family member notes
│   ├── Mia.md
│   └── Nick.md
├── Themes/
│   ├── Medical.md             # Topical organization
│   ├── School.md
│   └── Travel.md
├── inbox/
│   └── quick-notes.md         # Temporary storage
└── config/
    └── obsidian-nexus.yaml    # Local configuration

Ejemplos de Interacción

📝 Registro Familiar Diario

"Crea una nota para hoy sobre el entrenamiento de fútbol de Leo y la clase de piano de Mia"

Claude hará:

1. Crear Daily Notes/2025-06-22.md
2. Añadir contenido estructurado sobre ambas actividades
3. Enlazar a las notas individuales de los miembros de la familia

🔍 Encontrar Información

"¿Cuándo fue la última cita médica de Leo y qué dijo?"

Claude hará:

1. Buscar en todas las notas "Leo" + "médico"
2. Encontrar extractos relevantes con contexto
3. Proporcionar un resumen con citas de las fuentes

📊 Organizar Conocimiento

"Ayúdame a organizar toda la información médica dispersa en mis notas"

Claude hará:

1. Buscar contenido relacionado con medicina
2. Crear notas de tema organizadas
3. Actualizar las notas de los miembros de la familia con enlaces adecuados

Opciones de Configuración

Configuración Básica

vault_path: "/path/to/your/vault"    # Required: Your Obsidian vault path

family:
  people: ["Name1", "Name2"]         # Optional: Family member tracking

templates:
  daily_note: "Daily Notes/{{date}}.md"
  person_note: "Family/{{person}}.md"
  theme_note: "Themes/{{theme}}.md"

Opciones Avanzadas

structure:
  create_folders: true    # Auto-create folder structure
  use_daily_notes: true   # Enable daily notes pattern
  backup_files: true      # Keep backups of modified files

Casos de Uso

🏠 Gestión de la Vida Familiar

• Realiza seguimiento de actividades, citas y logros de los niños
• Organiza registros médicos y comunicaciones escolares
• Crea una base de conocimiento familiar buscable

📚 Gestión de Conocimiento Personal

• Organización y síntesis de notas de investigación
• Documentación y planificación de proyectos
• Registros de aprendizaje y materiales de estudio

💼 Trabajo y Proyectos

• Notas de reuniones y elementos de acción
• Documentación de proyectos y seguimiento de progreso
• Compartir conocimiento y colaboración en equipo

Beneficios sobre Obsidian Manual

🤖 Organización Impulsada por IA

• Claude entiende el contexto y las relaciones
• Estructura y enlaces automáticos de notas
• Síntesis inteligente de contenido

⚡ Velocidad y Eficiencia

• Comandos en lenguaje natural en lugar de clics manuales
• Búsqueda instantánea en toda la bóveda
• Operaciones por lotes y sugerencias inteligentes

🔗 Integración Perfecta

• Funciona junto con la aplicación Obsidian
• Conserva todas las funciones y complementos de Obsidian
• Markdown estándar: sin bloqueo de proveedor

Solución de Problemas

Problemas Comunes

"Archivo de configuración no encontrado"

• Asegúrate de que config.yaml exista en la raíz del proyecto
• Verifica que la ruta de la bóveda sea absoluta y correcta

"La ruta de la bóveda no existe"

• Verifica que la ruta apunte a un directorio válido
• Crea el directorio si no existe

"Permiso denegado"

• Comprueba los permisos de archivo/carpeta en el directorio de la bóveda
• Asegúrate de que la aplicación Obsidian no esté bloqueando archivos

Probando tu Configuración

# Test the server directly
node src/index.js

# Check configuration
vault_status

Privacidad y Seguridad

• Procesamiento solo local - sin dependencias en la nube
• Operaciones basadas en archivos - archivos Markdown estándar
• No se requieren claves API - Claude Desktop maneja el procesamiento de IA
• Código abierto - transparencia total del código

Hoja de Ruta

• Sistema avanzado de plantillas
• Soporte de integración de complementos
• Gestión de múltiples bóvedas
• Sincronización en tiempo real con la aplicación Obsidian
• Búsqueda avanzada con etiquetas y metadatos
• Utilidades de exportación/importación

Contribuciones

1. Haz un fork del repositorio
2. Crea una rama de características
3. Añade pruebas para la nueva funcionalidad
4. Envía una solicitud de extracción

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.

---

Obsidian Nexus - Tu bóveda, la inteligencia de Claude, armonía perfecta.