obsidian-mcp

Servidor MCP que convierte cualquier bóveda de Obsidian en un grafo de conocimiento consultable por IA.

Lo que lo diferencia de los más de 24 servidores MCP de Obsidian existentes:

• Primero el grafo — BFS, camino más corto, componentes conectados, detección de puentes mediante [[wikilinks]]

• Cero infraestructura — Sin base de datos, sin Obsidian en ejecución, sin claves API

• Independiente de la bóveda — Funciona con cualquier bóveda existente, sin estructura requerida

• Escrituras conscientes de backlinks — move_note actualiza automáticamente todas las referencias en la bóveda

• Diminuto — 4 dependencias en tiempo de ejecución, ~42KB de paquete

Inicio rápido

npx obsidian-mcp --vault ~/my-obsidian-vault

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp", "--vault", "/path/to/vault"]
    }
  }
}

Claude Code

claude mcp add obsidian -- npx -y obsidian-mcp --vault /path/to/vault

Related MCP server: some-vault-some-mcp

Herramientas (12)

Lectura y descubrimiento

Recorrido del grafo

Escritura y manipulación

Configuración

Sin configuración por defecto. Opcional .obsidian-mcp.json en la raíz de la bóveda:

{
  "ignore": ["templates/", "daily-notes/", ".trash/"],
  "watchDebounce": 100,
  "maxTraversalDepth": 10,
  "maxSearchResults": 500
}

Opciones de línea de comandos

--vault <path>       Path to Obsidian vault (required)
--verbose            Enable debug logging
--log-level <level>  error | warn | info | debug (default: info)

Cómo funciona

1. Al iniciar, escanea todos los archivos .md y construye un grafo en memoria (~1-3s para 1k notas)

2. El observador de archivos detecta cambios y actualiza el grafo de forma incremental (~5ms por cambio)

3. Claude consulta el grafo mediante herramientas MCP — no se necesita re-escaneo

4. Las operaciones de escritura actualizan tanto el sistema de archivos como el grafo de forma atómica

Exclusiones fijas: .obsidian/, .trash/, node_modules/

Desarrollo

npm install
npm test              # Run 66 tests
npm run build         # Build to dist/
npm run dev -- --vault test/fixtures/vault  # Dev mode

Licencia

MIT