Back to Home
Epistates icon

turbovault

Verified Safe

by Epistates

Overview

Transforms an Obsidian vault into an intelligent knowledge system, providing AI agents with specialized tools for reading, writing, searching, analyzing, and managing notes through a Model Context Protocol (MCP) server.

Installation

Run Command
turbovault --vault /path/to/your/vault --profile production --init

Environment Variables

  • OBSIDIAN_VAULT_PATH
  • RUST_LOG
  • OTEL_EXPORTER_OTLP_ENDPOINT

Security Notes

The project demonstrates comprehensive security features including explicit path traversal protection (using `path_trav` crate), type-safe deserialization to prevent injection, atomic file writes for data integrity, hash-based conflict detection for edits, and configurable file size limits to mitigate DoS attacks. Crucially, it avoids shell execution, eliminating command injection risks. An external `mcp-scanner` audit explicitly marks all 44 MCP tools as 'Safe: Yes'. While optional network transports (HTTP, WebSocket, TCP) introduce potential attack surfaces if enabled, the default mode for AI agent integration is `stdio`, which is inherently safer. The `docker-compose.yml` specifies running as a non-root `obsidian` user, adhering to the principle of least privilege.

Similar Servers

Stats

Interest Score51
Security Score10
Cost ClassHigh
Avg Tokens2000
Stars22
Forks4
Last Update2025-12-04

Tags

obsidianai-agent-toolsknowledge-graphvault-managementrust-server