Servidor MCP para Obsidian

Servidor MCP para interactuar con Obsidian a través del complemento de la comunidad API REST local.

Componentes

Herramientas

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

• list_files_in_vault: enumera todos los archivos y directorios en el directorio raíz de su bóveda de Obsidian

• list_files_in_dir: enumera todos los archivos y directorios en un directorio específico de Obsidian

• get_file_contents: Devuelve el contenido de un solo archivo en su bóveda.

• Buscar: busca documentos que coincidan con una consulta de texto específica en todos los archivos del almacén.

• patch_content: Inserta contenido en una nota existente relativa a un encabezado, referencia de bloque o campo frontmatter.

• append_content: agrega contenido a un archivo nuevo o existente en el almacén.

• delete_file: elimina un archivo o directorio de tu bóveda.

Ejemplos de indicaciones

Es bueno indicarle primero a Claude que use Obsidian. Así, siempre llamará a la herramienta.

El uso indica lo siguiente:

• Obtenga el contenido de la última nota de llamada de arquitectura y resúmalo

• Busque todos los archivos donde se menciona Azure CosmosDb y explíqueme rápidamente el contexto en el que se menciona

• Resume las notas de la última reunión y guárdalas en una nueva nota llamada "resumenreunión.md". Añade una introducción para que pueda enviarla por correo electrónico.

Related MCP server: MCP Tools for Obsidian

Configuración

Clave API REST de Obsidian

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

1. Agregar a la configuración del servidor (preferible)

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

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

OBSIDIAN_API_KEY=your_api_key_here
OBSIDIAN_HOST=your_obsidian_host

Nota: Puede encontrar la clave en la configuración del complemento Obsidian.

Inicio rápido

Instalar

API REST de Obsidian

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

Instálelo y habilítelo en la configuración y copie la clave API.

Escritorio de Claude

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

Edificio

Para preparar el paquete para su distribución:

1. Sincronizar dependencias y actualizar archivo de bloqueo:

uv sync

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

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

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su 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