Obsidian

Servidor MCP para Obsidian

Servidor MCP para interactuar con Obsidian mediante el plugin comunitario Local REST API.

Componentes

Herramientas

El servidor implementa múltiples herramientas para interactuar con Obsidian:

• list_files_in_vault: Lista todos los archivos y directorios en el directorio raíz de tu bóveda de Obsidian
• list_files_in_dir: Lista todos los archivos y directorios en un directorio específico de Obsidian
• get_file_contents: Devuelve el contenido de un solo archivo en tu bóveda.
• search: Busca documentos que coincidan con una consulta de texto especificada en todos los archivos de la bóveda
• patch_content: Inserta contenido en una nota existente en relación con un encabezado, referencia de bloque o campo de frontmatter.
• append_content: Añade contenido a un archivo nuevo o existente en la bóveda.

Ejemplos de indicaciones

Es bueno primero instruir a Claude para que use Obsidian. Luego siempre llamará a la herramienta.

Usa indicaciones como estas:

• Obtén el contenido de la última nota de llamada de arquitectura y resúmelo
• Busca todos los archivos donde se mencione Azure CosmosDb y explícame rápidamente el contexto en el que se menciona
• Resume las últimas notas de la reunión y colócalas en una nueva nota 'summary meeting.md'. Añade una introducción para que pueda enviarla por correo electrónico.

Configuración

Clave de API REST de Obsidian

Hay dos formas de configurar el entorno con la clave de API REST de Obsidian.

1. Añadir a la configuración del servidor (preferido)

{
  "mcp-obsidian": {
    "command": "uvx",
    "args": [
      "mcp-obsidian"
    ],
    "env": {
      "OBSIDIAN_API_KEY":"<your_api_key_here>"
    }
  }

2. Crea un archivo .env en el directorio de trabajo con la siguiente variable requerida:

OBSIDIAN_API_KEY=your_api_key_here

Nota: Puedes encontrar la clave en la configuración del plugin de Obsidian.

Inicio rápido

Instalación

API REST de Obsidian

Necesitas el plugin comunitario de API REST de Obsidian en ejecución: https://github.com/coddingtonbear/obsidian-local-rest-api

Instálalo y actívalo en la configuración y copia la clave de API.

Claude Desktop

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-obsidian",
        "run",
        "mcp-obsidian"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY" : "<YOUR_OBSIDIAN_API_KEY>"
      }
    }
  }
}

Desarrollo

Compilación

Para preparar el paquete para distribución:

1. Sincroniza las dependencias y actualiza el archivo de bloqueo:

uv sync

Depuración

Dado que los servidores MCP se ejecutan sobre stdio, la depuración puede ser desafiante. Para la mejor experiencia de depuración, recomendamos encarecidamente usar el Inspector MCP.

Puedes lanzar el Inspector MCP mediante npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-obsidian run mcp-obsidian

Al lanzarlo, el Inspector mostrará una URL que puedes acceder en tu navegador para comenzar a depurar.

También puedes ver los registros del servidor con este comando:

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-obsidian.log