Servidor MCP de Obsidian

Un servidor MCP (Protocolo de contexto de modelo) que permite a los asistentes de IA interactuar con las bóvedas de Obsidian, proporcionando herramientas para leer, crear, editar y administrar notas y etiquetas.

¡¡¡Advertencia!!!

Este MCP tiene acceso de lectura y escritura (si lo permite). Por favor, haga una copia de seguridad de su bóveda de Obsidian antes de usar obsidian-mcp para administrar sus notas. Recomiendo usar Git, pero cualquier método de copia de seguridad funcionará. Estas herramientas se han probado, pero no a fondo, y este MCP está en desarrollo.

Related MCP server: Vault Cortex

Características

• Leer y buscar notas en su bóveda

• Crear nuevas notas y directorios

• Editar notas existentes

• Mover y eliminar notas

• Administrar etiquetas (agregar, eliminar, renombrar)

• Buscar el contenido de la bóveda

Requisitos

• Node.js 20 o superior (podría funcionar en versiones anteriores, pero no lo he probado)

• Una bóveda de obsidiana

Instalar

Instalación manual

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

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Ventanas: %APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "obsidian": {
            "command": "npx",
            "args": ["-y", "obsidian-mcp", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

Reemplace /path/to/your/vault con la ruta absoluta a su bóveda de Obsidian. Por ejemplo:

MacOS/Linux:

"/Users/username/Documents/MyVault"

Ventanas:

"C:\\Users\\username\\Documents\\MyVault"

Reinicie Claude for Desktop después de guardar la configuración. Debería aparecer el icono del martillo, lo que indica que el servidor está conectado.

Si tiene problemas de conexión, consulte los registros en:

• MacOS: ~/Library/Logs/Claude/mcp*.log

• Ventanas: %APPDATA%\Claude\logs\mcp*.log

Instalación mediante herrería

Advertencia: No estoy afiliado a Smithery. No lo he probado y recomiendo a los usuarios que lo instalen manualmente si pueden.

Para instalar Obsidian para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install obsidian-mcp --client claude

Desarrollo

# Clone the repository
git clone https://github.com/StevenStavrakis/obsidian-mcp
cd obsidian-mcp

# Install dependencies
npm install

# Build
npm run build

Luego agrega a tu configuración de Claude Desktop:

{
    "mcpServers": {
        "obsidian": {
            "command": "node",
            "args": ["<absolute-path-to-obsidian-mcp>/build/main.js", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

Herramientas disponibles

• read-note - Leer el contenido de una nota

• create-note - Crea una nueva nota

• edit-note - Editar una nota existente

• delete-note - Eliminar una nota

• move-note - Mover una nota a una ubicación diferente

• create-directory - Crea un nuevo directorio

• search-vault - Buscar notas en la bóveda

• add-tags - Agregar etiquetas a una nota

• remove-tags - Eliminar etiquetas de una nota

• rename-tag - Cambiar el nombre de una etiqueta en todas las notas

• manage-tags - Listar y organizar etiquetas

• list-available-vaults : enumera todas las bóvedas disponibles (ayuda con configuraciones de múltiples bóvedas)

Documentación

Se puede encontrar documentación adicional en el directorio docs :

• creating-tools.md - Guía para crear nuevas herramientas

• tool-examples.md - Ejemplos de uso de las herramientas disponibles

Seguridad

Este servidor requiere acceso al directorio de su bóveda de Obsidian. Al configurar el servidor, asegúrese de lo siguiente:

• Proporcione acceso únicamente al directorio de bóveda previsto

• Revisar las acciones de la herramienta antes de aprobarlas

Solución de problemas

Problemas comunes:

1. El servidor no aparece en Claude Desktop

   • Verifique la sintaxis de su archivo de configuración

   • Asegúrese de que la ruta de la bóveda sea absoluta y exista

   • Reiniciar Claude Desktop

2. Errores de permisos

   • Asegúrese de que la ruta de la bóveda sea legible y escribible

   • Comprueba los permisos de archivos en tu bóveda

3. Fallos en la ejecución de herramientas

   • Consulte los registros de Claude Desktop en:

     • macOS: ~/Library/Logs/Claude/mcp*.log

     • Ventanas: %APPDATA%\Claude\logs\mcp*.log

Licencia

Instituto Tecnológico de Massachusetts (MIT)