# 🏛️ Arquitectura del Proyecto
El servidor **Obsidian MCP** está diseñado bajo una arquitectura modular y extensible, utilizando el framework `FastMCP` para facilitar la creación de herramientas, recursos y prompts.
## Estructura de Capas
El proyecto se organiza en las siguientes capas lógicas:
```mermaid
graph TD
A[FastMCP Server] --> B[Tools]
A --> C[Resources]
A --> D[Prompts]
subgraph Tools
B1[Navigation]
B2[Creation]
B3[Analysis]
B4[Graph]
B5[Agents]
B6[Semantic/RAG]
B7[YouTube]
end
subgraph Core
E[Config]
H[Vault Config]
F[Utils]
G[Semantic Service]
end
B --> Core
C --> Core
D --> Core
```
### 1. Servidor (`server.py`)
Es el punto de entrada principal. Se encarga de:
- Validar la configuración del vault.
- Instanciar `FastMCP`.
- Orquestar el registro de todos los módulos de herramientas, recursos y prompts.
### 2. Módulos de Herramientas (`obsidian_mcp/tools/`)
Cada dominio funcional tiene su propio archivo, lo que facilita el mantenimiento:
- **`navigation.py`**: Operaciones básicas de lectura y búsqueda.
- **`creation.py`**: Lógica de escritura, plantillas y gestión de archivos.
- **`analysis.py`**: Auditoría de metadatos y etiquetas.
- **`graph.py`**: Navegación por las conexiones entre notas.
- **`agents.py`**: Lee las skills (personalidades/roles) desde `{vault}/.agent/skills/` y las reglas globales desde `{vault}/.agent/REGLAS_GLOBALES.md`. Estos archivos están en el vault del usuario, no en el repositorio del MCP.
- **`semantic.py`**: Integración con el motor de búsqueda vectorial.
- **`youtube.py`**: Utilidad externa para transcripciones.
### 3. Servicio Semántico (`obsidian_mcp/semantic/`)
Este es un componente opcional (requiere dependencias extras) que gestiona:
- **Indexación**: Conversión de notas en embeddings y almacenamiento en `ChromaDB`.
- **RAG**: Pipeline de recuperación de información basado en similitud de coseno.
- **Metadatos**: Tracking de cambios para actualizaciones parciales del índice.
### 4. Utilidades y Configuración (`obsidian_mcp/utils/` y archivos de config)
- **`config.py`**: Gestión centralizada de variables de entorno mediante `python-dotenv`.
- **`vault_config.py`**: Lógica de auto-detección de la estructura del vault y carga opcional de `.agent/vault.yaml`.
- **`utils/`**: Funciones compartidas para manejo de strings, extracción de etiquetas y búsqueda de archivos.
## Flujo de una Petición MCP
1. El cliente (ej: Claude Desktop) envía una solicitud de herramienta.
2. `FastMCP` intercepta la llamada y la dirige a la función registrada.
3. El servidor valida que el acceso al vault sea seguro (dentro de los límites configurados).
4. La herramienta interactúa con el sistema de archivos o el servicio semántico.
5. Se devuelve una respuesta formateada al cliente.
