@mauricio.wolff/mcp-obsidian 0.7.5 → 0.8.2

package/README.md

@@ -23,16 +23,16 @@ A universal AI bridge for Obsidian vaults using the Model Context Protocol (MCP)
 
 </div>
 
-
-
 ## Universal Compatibility
-Works with any MCP-compatible AI assistant including Claude Desktop, Claude Code, ChatGPT Desktop (Enterprise+), IntelliJ IDEA 2025.1+, Cursor IDE, Windsurf IDE, and future AI platforms that adopt the MCP standard.
+
+Works with any MCP-compatible AI assistant including Claude Desktop, Claude Code, ChatGPT Desktop (Enterprise+), OpenCode, Gemini CLI, OpenAI Codex, IntelliJ IDEA 2025.1+, Cursor IDE, Windsurf IDE, and future AI platforms that adopt the MCP standard.
 
 https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c
 
 ## Quick Start (5 minutes)
 
 1. **Install Node.js runtime:**
+
    ```bash
    # Download from https://nodejs.org (v18.0.0 or later)
    # or use a package manager like nvm, brew, apt, etc.
@@ -41,6 +41,7 @@ https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c
 2. **Test the server:**
 
    If using the published package:
+
    ```bash
    npx @modelcontextprotocol/inspector npx @mauricio.wolff/mcp-obsidian@latest /path/to/your/vault
    ```
@@ -48,6 +49,7 @@ https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c
 3. **Configure your AI client:**
 
    **Claude Desktop** - Copy this to `claude_desktop_config.json`:
+
    ```json
    {
      "mcpServers": {
@@ -60,6 +62,7 @@ https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c
    ```
 
    **Claude Code** - Copy this to `~/.claude.json`:
+
    ```json
    {
      "mcpServers": {
@@ -72,6 +75,24 @@ https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c
    }
    ```
 
+   **OpenCode** - Copy this to `~/.config/opencode/opencode.json`
+
+   ```json
+   {
+     "mcp": {
+       "obsidian": {
+         "type": "local",
+         "command": [
+           "npx",
+           "@mauricio.wolff/mcp-obsidian@latest",
+           "/path/to/your/vault/"
+         ],
+         "enabled": true
+       }
+     }
+   }
+   ```
+
    Replace `/path/to/your/vault` with your actual Obsidian vault path.
 
    For other platforms, see [detailed configuration guides](#ai-client-configuration) below.
@@ -86,24 +107,27 @@ https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c
 ## Why MCP-Obsidian?
 
 ### Universal AI Compatibility
+
 Built on the open Model Context Protocol standard, MCP-Obsidian is not locked to any single AI provider. As more AI assistants adopt MCP, your investment in this tool grows more valuable. Today it works with Claude and ChatGPT - tomorrow it will work with whatever AI tools emerge.
 
 ### Future-Proof Your Knowledge Base
+
 Instead of waiting for each AI company to build Obsidian integrations, MCP-Obsidian provides a universal adapter that works with any MCP-compatible assistant. One tool, endless possibilities.
 
 ### Open Standard, No Lock-in
+
 MCP is an open protocol. You're not tied to any specific vendor or platform. Your notes remain yours, accessible through any compatible AI assistant.
 
 ## Features
 
 - ✅ Safe frontmatter parsing and validation using gray-matter
 - ✅ Path filtering to exclude `.obsidian` directory and other system files
-- ✅ **Complete MCP toolkit**: 11 methods covering all vault operations
-  - File operations: `read_note`, `write_note`, `delete_note`, `move_note`
+- ✅ **Complete MCP toolkit**: 14 methods covering all vault operations
+  - File operations: `read_note`, `write_note`, `patch_note`, `delete_note`, `move_note`, `move_file`
   - Directory operations: `list_directory`
   - Batch operations: `read_multiple_notes`
-  - Search: `search_notes` with content and frontmatter support
-  - Metadata: `get_frontmatter`, `update_frontmatter`, `get_notes_info`
+  - Search: `search_notes` with multi-word matching and BM25 relevance reranking
+  - Metadata: `get_frontmatter`, `update_frontmatter`, `get_notes_info`, `get_vault_stats`
   - Tag management: `manage_tags` (add, remove, list)
 - ✅ Write modes: `overwrite`, `append`, `prepend` for flexible content editing
 - ✅ Tag management: add, remove, and list tags in notes
@@ -119,7 +143,7 @@ MCP is an open protocol. You're not tied to any specific vendor or platform. You
 ## Prerequisites
 
 - [Node.js](https://nodejs.org) runtime (v18.0.0 or later)
-- An Obsidian vault (local directory with `.md` files)
+- An Obsidian vault (local directory with `.md`, `.markdown`, `.txt`, `.base`, or `.canvas` files)
 - MCP-compatible AI client (Claude Desktop, ChatGPT Desktop, Claude Code, etc.)
 
 ## Installation
@@ -132,24 +156,31 @@ No installation needed! Use `npx` to run directly:
 npx @mauricio.wolff/mcp-obsidian@latest /path/to/your/obsidian/vault
 ```
 
+If you omit the vault path, the server uses your current working directory as the vault root.
+
 ### For Developers
 
 1. Clone this repository
 2. Use the correct Node.js version:
+
 ```bash
 nvm use  # Uses Node 24 from .nvmrc
 ```
+
 3. Install dependencies with npm:
+
 ```bash
 npm install  # Corepack automatically uses npm 10.9.0
 ```
 
 4. Test locally with MCP inspector:
+
 ```bash
 npx @modelcontextprotocol/inspector npm start /path/to/your/vault
 ```
 
 **Pro tip:** Use MCP Inspector to test all server functionality before configuring with AI clients:
+
 ```bash
 # Install globally for easier access
 npm install -g @modelcontextprotocol/inspector
@@ -163,13 +194,19 @@ mcp-inspector npx @mauricio.wolff/mcp-obsidian@latest /path/to/your/vault
 ### Running the Server
 
 **End users:**
+
 ```bash
+npx @mauricio.wolff/mcp-obsidian@latest
 npx @mauricio.wolff/mcp-obsidian@latest /path/to/your/obsidian/vault
+npx @mauricio.wolff/mcp-obsidian@latest ./Vault
 ```
 
 **Developers:**
+
 ```bash
+npm start
 npm start /path/to/your/obsidian/vault
+npm start ./Vault
 ```
 
 ### AI Client Configuration
@@ -179,39 +216,51 @@ npm start /path/to/your/obsidian/vault
 Add to your Claude Desktop configuration file:
 
 **Single Vault:**
+
 ```json
 {
   "mcpServers": {
     "obsidian": {
       "command": "npx",
-      "args": ["@mauricio.wolff/mcp-obsidian@latest", "/Users/yourname/Documents/MyVault"]
+      "args": [
+        "@mauricio.wolff/mcp-obsidian@latest",
+        "/Users/yourname/Documents/MyVault"
+      ]
     }
   }
 }
 ```
 
 **Multiple Vaults:**
+
 ```json
 {
   "mcpServers": {
     "obsidian-personal": {
       "command": "npx",
-      "args": ["@mauricio.wolff/mcp-obsidian@latest", "/Users/yourname/Documents/PersonalVault"]
+      "args": [
+        "@mauricio.wolff/mcp-obsidian@latest",
+        "/Users/yourname/Documents/PersonalVault"
+      ]
     },
     "obsidian-work": {
       "command": "npx",
-      "args": ["@mauricio.wolff/mcp-obsidian@latest", "/Users/yourname/Documents/WorkVault"]
+      "args": [
+        "@mauricio.wolff/mcp-obsidian@latest",
+        "/Users/yourname/Documents/WorkVault"
+      ]
     }
   }
 }
 ```
 
 **Configuration File Locations:**
+
 - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Windows:** `C:\Users\{username}\AppData\Roaming\Claude\claude_desktop_config.json`
 - **Linux:** `~/.config/Claude/claude_desktop_config.json`
 
-*You can also access this through Claude Desktop → Settings → Developer → Edit Config*
+_You can also access this through Claude Desktop → Settings → Developer → Edit Config_
 
 #### ChatGPT Desktop
 
@@ -223,7 +272,7 @@ ChatGPT uses MCP through Deep Research and developer mode. Configuration is done
 2. Configure MCP servers through the built-in MCP client
 3. Create custom connectors for your organization
 
-*Note: ChatGPT Desktop's MCP integration is currently limited to enterprise subscriptions and uses a different setup process than file-based configuration.*
+_Note: ChatGPT Desktop's MCP integration is currently limited to enterprise subscriptions and uses a different setup process than file-based configuration._
 
 #### Claude Code
 
@@ -231,6 +280,7 @@ Claude Code uses `.claude.json` configuration file:
 
 **User-scoped (recommended):**
 Edit `~/.claude.json`:
+
 ```json
 {
   "mcpServers": {
@@ -245,6 +295,7 @@ Edit `~/.claude.json`:
 
 **Project-scoped:**
 Edit `.claude.json` in your project or add to the projects section:
+
 ```json
 {
   "projects": {
@@ -261,6 +312,7 @@ Edit `.claude.json` in your project or add to the projects section:
 ```
 
 **Using Claude Code CLI:**
+
 ```bash
 claude mcp add obsidian --scope user npx @mauricio.wolff/mcp-obsidian /path/to/your/vault
 ```
@@ -276,6 +328,7 @@ npx @mauricio.wolff/mcp-obsidian@latest /path/to/your/vault
 #### Other MCP-Compatible Clients (2025)
 
 **Confirmed MCP Support:**
+
 - **IntelliJ IDEA 2025.1+** - Native MCP client support
 - **Cursor IDE** - Built-in MCP compatibility
 - **Windsurf IDE** - Full MCP integration
@@ -287,11 +340,13 @@ Most modern MCP clients use similar JSON configuration patterns. Refer to your s
 ### Examples
 
 #### Ask your AI assistant about your notes:
+
 - "What files are in my Obsidian vault?"
 - "Read my note called 'project-ideas.md'"
 - "Show me all notes with 'AI' in the title"
 
 #### Have your AI assistant help with note management:
+
 - "Create a new note called 'meeting-notes.md' with today's date in the frontmatter"
 - "Append today's journal entry to my daily note"
 - "Prepend an urgent task to my todo list"
@@ -302,6 +357,7 @@ Most modern MCP clients use similar JSON configuration patterns. Refer to your s
 - "Delete the old draft note 'draft-ideas.md' (with confirmation)"
 
 #### Advanced Use Cases:
+
 - **Knowledge Synthesis**: "Summarize all my research notes tagged with 'machine-learning' from the last month"
 - **Project Management**: "Update the status in all project notes to 'completed' and add today's date"
 - **Content Analysis**: "Find all notes that mention 'API design' and create a comprehensive guide"
@@ -312,22 +368,27 @@ Most modern MCP clients use similar JSON configuration patterns. Refer to your s
 ### Common Issues
 
 #### "command not found: npx"
+
 - **Solution:** Install Node.js runtime from [nodejs.org](https://nodejs.org)
 - **Alternative:** Use global install: `npm install -g @mauricio.wolff/mcp-obsidian`
 
-#### "Usage: node server.ts /path/to/vault"
-- **Cause:** No vault path provided
-- **Solution:** Specify the full path to your Obsidian vault directory
+#### "File not found" when paths look correct
+
+- **Cause:** The server is using the wrong vault root
+- **Solution:** Either run the command from your vault directory or pass the vault path explicitly
 
 #### "Permission denied" errors
+
 - **Cause:** Insufficient file system permissions
 - **Solution:** Ensure the vault directory is readable/writable by your user
 
 #### "Path traversal not allowed"
+
 - **Cause:** Trying to access files outside the vault
 - **Solution:** All file paths must be relative to the vault root
 
 #### AI client not recognizing the server
+
 1. Check the configuration file path is correct for your OS
 2. Ensure JSON syntax is valid (use a JSON validator)
 3. Restart your AI client after configuration changes
@@ -335,12 +396,14 @@ Most modern MCP clients use similar JSON configuration patterns. Refer to your s
 5. Verify your AI client supports MCP (Model Context Protocol)
 
 #### ".obsidian files still showing up"
+
 - **Expected:** The path filter automatically excludes `.obsidian/**` patterns
 - **If still seeing them:** The filter is working as designed for security
 
 ### Debug Mode
 
 Run with error logging:
+
 ```bash
 npx @mauricio.wolff/mcp-obsidian /path/to/vault 2>debug.log
 ```
@@ -354,6 +417,7 @@ npx @mauricio.wolff/mcp-obsidian /path/to/vault 2>debug.log
 ## Testing
 
 Run the test suite:
+
 ```bash
 npm test
 ```
@@ -361,9 +425,11 @@ npm test
 ## API Methods
 
 ### `read_note`
+
 Read a note from the vault with parsed frontmatter.
 
 **Request:**
+
 ```json
 {
   "name": "read_note",
@@ -375,11 +441,20 @@ Read a note from the vault with parsed frontmatter.
 ```
 
 **Response (optimized for tokens):**
+
 ```json
-{"fm":{"title":"Project Ideas","tags":["projects","brainstorming"],"created":"2023-01-15T10:30:00.000Z"},"content":"# Project Ideas\n\n## AI Tools\n- MCP server for Obsidian\n- Voice note transcription\n\n## Web Apps\n- Task management system"}
+{
+  "fm": {
+    "title": "Project Ideas",
+    "tags": ["projects", "brainstorming"],
+    "created": "2023-01-15T10:30:00.000Z"
+  },
+  "content": "# Project Ideas\n\n## AI Tools\n- MCP server for Obsidian\n- Voice note transcription\n\n## Web Apps\n- Task management system"
+}
 ```
 
 **Response (with prettyPrint: true):**
+
 ```json
 {
   "fm": {
@@ -392,14 +467,17 @@ Read a note from the vault with parsed frontmatter.
 ```
 
 ### `write_note`
+
 Write a note to the vault with optional frontmatter and write mode.
 
 **Write Modes:**
+
 - `overwrite` (default): Replace entire file content
 - `append`: Add content to the end of existing file
 - `prepend`: Add content to the beginning of existing file
 
 **Request (Overwrite):**
+
 ```json
 {
   "name": "write_note",
@@ -417,6 +495,7 @@ Write a note to the vault with optional frontmatter and write mode.
 ```
 
 **Request (Append):**
+
 ```json
 {
   "name": "write_note",
@@ -429,16 +508,61 @@ Write a note to the vault with optional frontmatter and write mode.
 ```
 
 **Response:**
+
 ```json
 {
   "message": "Successfully wrote note: meeting-notes.md (mode: overwrite)"
 }
 ```
 
+### `patch_note`
+
+Efficiently replace an exact string inside an existing note without rewriting the full file.
+
+**Request:**
+
+```json
+{
+  "name": "patch_note",
+  "arguments": {
+    "path": "meeting-notes.md",
+    "oldString": "- Next milestones",
+    "newString": "- Next milestones (owner: Alex)",
+    "replaceAll": false
+  }
+}
+```
+
+**Response (success):**
+
+```json
+{
+  "success": true,
+  "path": "meeting-notes.md",
+  "message": "Successfully replaced 1 occurrence",
+  "matchCount": 1
+}
+```
+
+**Response (multiple matches with replaceAll=false):**
+
+```json
+{
+  "success": false,
+  "path": "meeting-notes.md",
+  "message": "Found 3 occurrences of the string. Use replaceAll=true to replace all occurrences, or provide a more specific string to match exactly one occurrence.",
+  "matchCount": 3
+}
+```
+
 ### `list_directory`
+
 List files and directories in the vault.
 
+Note: this includes non-note filenames (for example `pdf`, `png`, `jpg`) so AI assistants can see vault structure, but note tools like `read_note` and `write_note` still operate on note files only (`.md`, `.markdown`, `.txt`, `.base`, `.canvas`).
+
 **Request:**
+
 ```json
 {
   "name": "list_directory",
@@ -450,14 +574,20 @@ List files and directories in the vault.
 ```
 
 **Response (optimized):**
+
 ```json
-{"dirs":["AI-Tools","Web-Development"],"files":["project-template.md","roadmap.md"]}
+{
+  "dirs": ["AI-Tools", "Web-Development"],
+  "files": ["project-template.md", "roadmap.md"]
+}
 ```
 
 ### `delete_note`
+
 Delete a note from the vault (requires confirmation for safety).
 
 **Request:**
+
 ```json
 {
   "name": "delete_note",
@@ -469,6 +599,7 @@ Delete a note from the vault (requires confirmation for safety).
 ```
 
 **Response (Success):**
+
 ```json
 {
   "success": true,
@@ -478,6 +609,7 @@ Delete a note from the vault (requires confirmation for safety).
 ```
 
 **Response (Confirmation Failed):**
+
 ```json
 {
   "success": false,
@@ -489,9 +621,11 @@ Delete a note from the vault (requires confirmation for safety).
 **⚠️ Safety Note:** The `confirmPath` parameter must exactly match the `path` parameter to proceed with deletion. This prevents accidental deletions.
 
 ### `get_frontmatter`
+
 Extract only the frontmatter from a note without reading the full content.
 
 **Request:**
+
 ```json
 {
   "name": "get_frontmatter",
@@ -503,14 +637,21 @@ Extract only the frontmatter from a note without reading the full content.
 ```
 
 **Response (optimized, returns frontmatter directly):**
+
 ```json
-{"title":"Project Ideas","tags":["projects","brainstorming"],"created":"2023-01-15T10:30:00.000Z"}
+{
+  "title": "Project Ideas",
+  "tags": ["projects", "brainstorming"],
+  "created": "2023-01-15T10:30:00.000Z"
+}
 ```
 
 ### `manage_tags`
+
 Add, remove, or list tags in a note. Tags are managed in the frontmatter and inline tags are detected.
 
 **Request (List Tags):**
+
 ```json
 {
   "name": "manage_tags",
@@ -522,6 +663,7 @@ Add, remove, or list tags in a note. Tags are managed in the frontmatter and inl
 ```
 
 **Request (Add Tags):**
+
 ```json
 {
   "name": "manage_tags",
@@ -534,6 +676,7 @@ Add, remove, or list tags in a note. Tags are managed in the frontmatter and inl
 ```
 
 **Request (Remove Tags):**
+
 ```json
 {
   "name": "manage_tags",
@@ -546,6 +689,7 @@ Add, remove, or list tags in a note. Tags are managed in the frontmatter and inl
 ```
 
 **Response:**
+
 ```json
 {
   "path": "research-notes.md",
@@ -557,9 +701,11 @@ Add, remove, or list tags in a note. Tags are managed in the frontmatter and inl
 ```
 
 ### `search_notes`
-Search for notes in the vault by content or frontmatter.
+
+Search for notes in the vault by content or frontmatter with multi-word matching and BM25 relevance reranking.
 
 **Request:**
+
 ```json
 {
   "name": "search_notes",
@@ -575,21 +721,35 @@ Search for notes in the vault by content or frontmatter.
 ```
 
 **Response (optimized with minified field names):**
+
 ```json
-[{"p":"ai-research.md","t":"AI Research Notes","ex":"...machine learning...","mc":2,"ln":15}]
+[
+  {
+    "p": "ai-research.md",
+    "t": "AI Research Notes",
+    "ex": "...machine learning...",
+    "mc": 2,
+    "ln": 15,
+    "uri": "obsidian://open?vault=MyVault&file=ai-research.md"
+  }
+]
 ```
 
 **Field names:**
+
 - `p` = path
 - `t` = title
 - `ex` = excerpt (21 chars context)
 - `mc` = match count
 - `ln` = line number
+- `uri` = Obsidian deep link for quick opening
 
 ### `move_note`
-Move or rename a note in the vault.
+
+Move or rename a note in the vault (`.md`, `.markdown`, `.txt`, `.base`, `.canvas`).
 
 **Request:**
+
 ```json
 {
   "name": "move_note",
@@ -602,6 +762,7 @@ Move or rename a note in the vault.
 ```
 
 **Response:**
+
 ```json
 {
   "success": true,
@@ -611,10 +772,44 @@ Move or rename a note in the vault.
 }
 ```
 
+### `move_file`
+
+Move or rename any file in the vault with binary-safe file operations (file-only; not recursive directory moves). For safety, this tool requires confirmation of both source and destination paths.
+
+**Request:**
+
+```json
+{
+  "name": "move_file",
+  "arguments": {
+    "oldPath": "Miro/attachments/Pasted image 20250812140124.png",
+    "newPath": "assets/images/Pasted image 20250812140124.png",
+    "confirmOldPath": "Miro/attachments/Pasted image 20250812140124.png",
+    "confirmNewPath": "assets/images/Pasted image 20250812140124.png",
+    "overwrite": false
+  }
+}
+```
+
+**Response:**
+
+```json
+{
+  "success": true,
+  "oldPath": "Miro/attachments/Pasted image 20250812140124.png",
+  "newPath": "assets/images/Pasted image 20250812140124.png",
+  "message": "Successfully moved file from Miro/attachments/Pasted image 20250812140124.png to assets/images/Pasted image 20250812140124.png"
+}
+```
+
+**Safety Note:** `confirmOldPath` must exactly match `oldPath`, and `confirmNewPath` must exactly match `newPath`, otherwise the move is rejected.
+
 ### `read_multiple_notes`
+
 Read multiple notes in a batch (maximum 10 files).
 
 **Request:**
+
 ```json
 {
   "name": "read_multiple_notes",
@@ -628,18 +823,31 @@ Read multiple notes in a batch (maximum 10 files).
 ```
 
 **Response (optimized, shortened field names):**
+
 ```json
-{"ok":[{"path":"note1.md","frontmatter":{"title":"Note 1"},"content":"# Note 1\n\nContent here..."}],"err":[{"path":"note2.md","error":"File not found"}]}
+{
+  "ok": [
+    {
+      "path": "note1.md",
+      "frontmatter": { "title": "Note 1" },
+      "content": "# Note 1\n\nContent here..."
+    }
+  ],
+  "err": [{ "path": "note2.md", "error": "File not found" }]
+}
 ```
 
 **Field names:**
+
 - `ok` = successful reads
 - `err` = failed reads
 
 ### `update_frontmatter`
+
 Update frontmatter of a note without changing content.
 
 **Request:**
+
 ```json
 {
   "name": "update_frontmatter",
@@ -655,6 +863,7 @@ Update frontmatter of a note without changing content.
 ```
 
 **Response:**
+
 ```json
 {
   "message": "Successfully updated frontmatter for: research-note.md"
@@ -662,9 +871,11 @@ Update frontmatter of a note without changing content.
 ```
 
 ### `get_notes_info`
+
 Get metadata for notes without reading full content.
 
 **Request:**
+
 ```json
 {
   "name": "get_notes_info",
@@ -676,8 +887,49 @@ Get metadata for notes without reading full content.
 ```
 
 **Response (optimized, returns array directly):**
+
+```json
+[
+  {
+    "path": "note1.md",
+    "size": 1024,
+    "modified": 1695456000000,
+    "hasFrontmatter": true
+  }
+]
+```
+
+### `get_vault_stats`
+
+Get high-level vault statistics without reading note contents.
+
+**Request:**
+
+```json
+{
+  "name": "get_vault_stats",
+  "arguments": {
+    "recentCount": 5,
+    "prettyPrint": false
+  }
+}
+```
+
+**Response (optimized):**
+
 ```json
-[{"path":"note1.md","size":1024,"modified":1695456000000,"hasFrontmatter":true}]
+{
+  "notes": 1248,
+  "folders": 76,
+  "size": 18349210,
+  "recent": [
+    {
+      "path": "Daily/2026-02-27.md",
+      "modified": 1772188800000,
+      "size": 2814
+    }
+  ]
+}
 ```
 
 ## Security Considerations
@@ -685,27 +937,32 @@ Get metadata for notes without reading full content.
 This MCP server implements several security measures to protect your Obsidian vault:
 
 ### Path Security
+
 - **Path Traversal Protection:** All file paths are validated to prevent access outside the vault
 - **Relative Path Enforcement:** Paths are normalized and restricted to the vault directory
 - **Symbolic Link Safety:** Resolved paths are checked against vault boundaries
 
 ### File Filtering
+
 - **Automatic Exclusions:** `.obsidian`, `.git`, `node_modules`, and system files are filtered
-- **Extension Whitelist:** Only `.md`, `.markdown`, and `.txt` files are accessible by default
+- **Extension Whitelist:** Only `.md`, `.markdown`, `.txt`, `.base`, and `.canvas` files are accessible by default
 - **Hidden File Protection:** Dot files and system directories are automatically excluded
 
 ### Content Validation
+
 - **YAML Frontmatter Validation:** Frontmatter is parsed and validated before writing
 - **Function/Symbol Prevention:** Dangerous JavaScript objects are blocked from frontmatter
 - **Data Type Checking:** Only safe data types (strings, numbers, arrays, objects) allowed
 
 ### Best Practices
+
 - **Least Privilege:** Server only accesses the specified vault directory
 - **Read-Only by Default:** Consider running with read-only permissions for sensitive vaults
 - **Backup Recommended:** Always backup your vault before using write operations
 - **Network Isolation:** Server uses stdio transport (no network exposure)
 
 ### What's NOT Protected
+
 - **File Content:** The server can read/write any allowed file content
 - **Vault Structure:** Directory structure is visible to AI assistants
 - **File Metadata:** Creation times, file sizes, etc. are accessible
@@ -719,6 +976,7 @@ This MCP server implements several security measures to protect your Obsidian va
 - `src/filesystem.ts` - Safe file operations with path validation
 - `src/pathfilter.ts` - Directory and file filtering
 - `src/search.ts` - Note search functionality with content and frontmatter support
+- `src/uri.ts` - Obsidian URI generation for deep links
 - `src/types.ts` - TypeScript type definitions
 
 ## Contributing