Obsidian MCP Local

MCP local en Node.js + TypeScript para exponer tu vault de Obsidian a VS Code + GitHub Copilot.

Ha sido diseñado para uso local mediante stdio, con enfoque en leer y escribir notas Markdown dentro de tu vault.

Features

Herramientas disponibles

• search_notes(query)

  • busca por texto en la ruta, frontmatter y contenido de las notas

  • devuelve resultados clasificados con un pequeño extracto

• get_note(path)

  • abre una nota del vault

  • devuelve path, frontmatter y content

• create_note(path, content, overwrite?)

  • crea una nota nueva

  • opcionalmente sobrescribe una nota existente

• append_to_note(path, content)

  • añade contenido al final de una nota existente

• find_by_tag(tag)

  • encuentra notas por etiqueta

  • admite tags en el frontmatter y etiquetas inline en el contenido

Reglas implementadas

• solo accede a archivos dentro del vault configurado

• ignora directorios como:

  • .obsidian

  • .git

  • node_modules

• trabaja solo con archivos .md

• normaliza rutas para evitar el acceso fuera del directorio base

Estructura del proyecto

obsidian-mcp-local/
  package.json
  tsconfig.json
  README.md
  .vscode/
    mcp.example.json
  src/
    index.ts

Requisitos previos

• Node.js 20+

• npm

• VS Code con GitHub Copilot

• un vault de Obsidian local

Instalación

En el directorio del proyecto:

npm install
npm run build

Para desarrollo:

npm run dev

Para ejecutar la versión compilada:

npm start

Cómo usar en VS Code

1. Compila el proyecto

npm install
npm run build

2. Ajusta el archivo MCP de VS Code

Copia el contenido de .vscode/mcp.example.json a tu .vscode/mcp.json en el espacio de trabajo donde vayas a usar Copilot.

Ejemplo:

{
  "servers": {
    "obsidian-local-vault": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/caminho/para/obsidian-mcp-local/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
      }
    }
  }
}

3. Actualiza las rutas

Sustituye:

• C:/caminho/para/obsidian-mcp-local/dist/index.js

• D:/Obsidian/Vault

por las rutas reales de tu máquina.

4. Reinicia/recarga VS Code

Después de esto, Copilot debería descubrir el servidor MCP.

Ejemplos de uso en Copilot Chat

• “Busca en mi vault notas sobre .NET”

• “Abre la nota knowledge/backend/dotnet.md”

• “Crea una nota en inbox/ideias-mcp.md con un resumen de lo que discutimos”

• “Añade al final de la nota daily/2026-04-06.md el texto - testar MCP local”

• “Encuentra notas con la etiqueta #arquitetura”

Posibles mejoras futuras

• append_under_heading

• análisis de [[wikilinks]]

• get_backlinks(note)

• índice en SQLite para búsqueda rápida

• lista blanca de carpetas para escritura (inbox/, daily/, scratch/)

• bloqueo configurable de escritura en determinadas carpetas

Observaciones importantes

• Este proyecto no depende de que Obsidian esté abierto.

• Opera directamente sobre los archivos del vault.

• Si habilitas la escritura tanto en Obsidian como en VS Code, el control de concurrencia queda bajo tu responsabilidad.

• El proyecto actualmente asume que el vault es una carpeta Markdown local.

Archivo principal

La implementación está en:

• src/index.ts

Licencia

Uso personal / base inicial para personalización.