Protocolo de contexto modelo (MCP) de Obsidian

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

Prerrequisitos

• Node.js 18 o superior

• Obsidian con el complemento API REST local instalado y configurado

• Clave API generada desde el complemento API REST local

Related MCP server: Obsidian MCP Server Plugin

Configuración del servidor MCP (por ejemplo, la aplicación de escritorio Claude)

1. Clonar este repositorio

2. Instalar dependencias:

   npm install

3. Construir el proyecto:

   npm run build

4. Configurar la aplicación de escritorio Claude para utilizar 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

Cree .env y configure "apiKey", "port" y "host" como se mencionó anteriormente.

Herramientas disponibles

Se implementan las siguientes herramientas:

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

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

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

   {}

3. listNotes : enumera de forma recursiva archivos y carpetas en todo el almacén o en una carpeta específica

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

4. patchNote : inserta contenido en una nota existente relativa a un encabezado, una referencia de bloque o un campo 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 con consultas en formato JsonLogic

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