🧠 Obsidian MCP Server

Un servidor avanzado de MCP (Model Context Protocol) que convierte tu vault de Obsidian en un cerebro dinámico para tu IA (Claude Desktop, IDEs, etc.). Mucho más que un lector de archivos: es un ecosistema de herramientas para la gestión del conocimiento, automatización y análisis semántico.

✨ Características Principales

🛠️ Ecosistema de Herramientas (30+)

El servidor expone una amplia variedad de herramientas categorizadas por su función:

📂 Navegación: Listado inteligente, lectura recursiva y búsqueda avanzada.
✍️ Creación y Edición: Uso automático de plantillas (ZZ_Plantillas), sugerencia de ubicación y edición con preservación de metadatos.
📊 Análisis y Calidad: Estadísticas del vault, sincronización de etiquetas con el registro oficial y comprobación de integridad.
🕸️ Grafos y Conexiones: Análisis de backlinks, detección de notas huérfanas y visualización de grafos locales.
🤖 Sistema de Agentes: Carga dinámica de personalidades desde .github/agents.
🔍 Búsqueda Semántica (RAG): Búsquedas por significado, sugerencia de conexiones no obvias e indexación vectorial.
📺 YouTube: Extracción de transcripciones para alimentar tu base de conocimientos.

🤖 Inteligencia Integrada

Plantillas Dinámicas: Reemplazo automático de variables en archivos de ZZ_Plantillas.
Smart Tagging: Consulta el historial de etiquetas para mantener la coherencia semántica.
Seguridad: Protección estricta de carpetas sensibles y validación de rutas.

🚀 Instalación Rápida

Prerrequisitos

Python 3.11+
uv (Recomendado)

Pasos

Clonar:

git clone https://github.com/Vasallo94/obsidian-mcp-server.git
cd obsidian-mcp-server

Instalar:

make install
# Para búsqueda semántica:
pip install "obsidian-mcp-server[rag]"

Configurar:

cp .env.example .env
# Edita .env con la ruta absoluta a tu vault

💻 Uso

Integración con Claude Desktop

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "uv",
      "args": ["run", "obsidian-mcp-server"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/Ruta/A/Tu/Vault"
      }
    }
  }
}

📚 Documentación Técnica

Para profundizar en el funcionamiento del servidor, consulta nuestras guías detalladas en la carpeta docs/:

🏛️ Arquitectura: Estructura modular y flujo de datos.
🔧 Referencia de Herramientas: Listado completo y parámetros de cada herramienta.
⚙️ Configuración: Guía sobre variables de entorno y carpetas especiales.
🧠 Búsqueda Semántica (RAG): Cómo funciona la indexación vectorial y el modo RAG.

🛠️ Desarrollo y Calidad

Comando	Descripción
`make test`	Ejecuta la suite de pruebas (pytest)
`make lint`	Verificación estática (Ruff + Mypy)
`make format`	Formateo automático de código
`make dev`	Ejecuta el inspector de MCP para pruebas en vivo

📄 Licencia

Este proyecto está bajo la licencia MIT.

obsidian-mcp-server