Obsidian MCP

Obsidian MCP (Model Context Protocol)

Obsidian MCP es una herramienta que te permite interactuar con tu bóveda de Obsidian mediante el Protocolo de Contexto del Modelo. Esto permite a los asistentes de IA leer, escribir y manipular notas en tu bóveda de Obsidian a través de una interfaz estandarizada.

Requisitos previos

• Node.js 18 o superior
• Obsidian con el plugin Local REST API plugin instalado y configurado
• Clave de API generada desde el plugin Local REST API

Configuración del servidor MCP (por ejemplo, Claude Desktop App)

1. Clona este repositorio

2. Instala las dependencias:

   npm install
   

3. Compila el proyecto:

   npm run build
   

4. Configura Claude Desktop App para usar este servidor MCP:

   {
      "mcpServers": {
        "Obsidian": {
          "command": "node",
          "args": ["/Users/<Your Own Path>/obsisian-mcp/build/index.js"],
          "env": {
            "apiKey": "<Your API Token>",
            "port": "27123",
            "host": "127.0.0.1"
          }
        }
      }
    }
   

Desarrollo

Crea .env y configura "apiKey", "port" y "host" como se mencionó anteriormente.

Herramientas disponibles

Las siguientes herramientas están implementadas:

1. readNote - Lee el contenido de una nota específica

   {
     "path": "path/to/note.md"
   }
   

2. readActiveNote - Lee el contenido de la nota activa actual

   {}
   

3. listNotes - Lista recursivamente archivos y carpetas en toda la bóveda o bajo una carpeta especificada

   {
     "path": "optional/folder/path"
   }
   

4. patchNote - Inserta contenido en una nota existente en relación con un encabezado, referencia de bloque o campo de frontmatter

   {
     "path": "path/to/note.md",
     "operation": "append|prepend|replace",
     "targetType": "heading|block|frontmatter",
     "target": "target_identifier",
     "content": "content to insert"
   }
   

5. searchWithJsonLogic - Busca notas de Obsidian usando consultas en formato JsonLogic

   {
     "query": {
       // JsonLogic query object
     }
   }