Obsidiana MCP

Servidor de Protocolo de Contexto de Modelo para la integración de la bóveda de Obsidian. Esto permite que Claude Desktop (o cualquier cliente MCP) busque y lea sus notas de Obsidian.

Inicio rápido (para usuarios)

Prerrequisitos

• Node.js 18+ (instalación mediante brew install node )

• Bóveda de obsidiana

• Claude Desktop (instalación desde https://claude.ai/desktop )

Configuración

1. Abra el archivo de configuración de Claude Desktop en: ~/Library/Application Support/Claude/claude_desktop_config.json

Puedes encontrarlo a través del menú de Claude Desktop:

1. Abra Claude Desktop

2. Haga clic en Claude en la barra de menú de Mac

3. Haga clic en "Configuración"

4. Haga clic en "Desarrollador"

5. Añade lo siguiente a tu configuración:

{
  "tools": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-obsidian"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

Nota: Reemplace /path/to/your/obsidian/vault con su ruta de bóveda de Obsidian real.

Related MCP server: MCP Tools for Obsidian

Para desarrolladores

Prerrequisitos

• Node.js 18+ (instalación mediante brew install node )

• Bóveda de obsidiana

• Claude Desktop (instalación desde https://claude.ai/desktop )

• tsx (instalación mediante npm install -g tsx )

Instalación

git clone https://github.com/kazuph/mcp-obsidian.git
cd mcp-obsidian
npm install
npm run build

Configuración

1. Asegúrese de que Claude Desktop esté instalado y funcionando.

2. Instale tsx globalmente si aún no lo ha hecho:

npm install -g tsx
# or
pnpm add -g tsx

3. Modifique la configuración de Claude Desktop ubicada en: ~/Library/Application Support/Claude/claude_desktop_config.json

Puedes encontrarlo fácilmente a través del menú de Claude Desktop:

1. Abra Claude Desktop

2. Haga clic en Claude en la barra de menú de Mac

3. Haga clic en "Configuración"

4. Haga clic en "Desarrollador"

Agregue lo siguiente a la configuración de su cliente MCP:

{
  "tools": {
    "obsidian": {
      "args": ["tsx", "/path/to/mcp-obsidian/index.ts"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

Herramientas disponibles

• obsidian_read_notes : Lee el contenido de varias notas. El contenido de cada nota se devuelve con su ruta como referencia.

• obsidian_search_notes : busca notas por nombre (sin distinguir entre mayúsculas y minúsculas, admite coincidencias parciales y expresiones regulares).

• obsidian_read_notes_dir : enumera la estructura del directorio bajo una ruta especificada.

• obsidian_write_note : crea una nueva nota en la ruta especificada.