@mauricio.wolff/mcp-obsidian 0.5.4 → 0.5.5

package/README.md

@@ -1,8 +1,16 @@
+<div align="center">
+  <img width="256" height="256" alt="image" src="https://github.com/user-attachments/assets/1e21d898-811b-42c2-a810-bf921dde0f58" />
+</div>
+
 # MCP-Obsidian
 
-A lightweight Model Context Protocol (MCP) server for safe Obsidian vault access. This server provides AI assistants with the ability to read and write notes in an Obsidian vault while preventing YAML frontmatter corruption.
+A universal AI bridge for Obsidian vaults using the Model Context Protocol (MCP) standard. Connect any MCP-compatible AI assistant to your knowledge base - works with Claude, ChatGPT, and future AI tools. This server provides safe read/write access to your notes while preventing YAML frontmatter corruption.
+
+🌐 **Website:** [mcp-obsidian.org](https://mcp-obsidian.org)
+
+**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.
 
-**Supported AI Platforms:** Claude Desktop, Claude Code, ChatGPT Desktop (Enterprise+), IntelliJ IDEA 2025.1+, Cursor IDE, and other MCP-compatible clients.
+https://github.com/user-attachments/assets/657ac4c6-1cd2-4cc3-829f-fd095a32f71c
 
 ## Quick Start (5 minutes)
 
@@ -57,6 +65,17 @@ A lightweight Model Context Protocol (MCP) server for safe Obsidian vault access
 
 **Success indicators:** Your AI should be able to list files and read notes from your vault.
 
+## 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
@@ -68,12 +87,15 @@ A lightweight Model Context Protocol (MCP) server for safe Obsidian vault access
   - Search: `search_notes` with content and frontmatter support
   - Metadata: `get_frontmatter`, `update_frontmatter`, `get_notes_info`
   - Tag management: `manage_tags` (add, remove, list)
-- ✅ **NEW:** Write modes: `overwrite`, `append`, `prepend` for flexible content editing
-- ✅ **NEW:** Tag management: add, remove, and list tags in notes
+- ✅ Write modes: `overwrite`, `append`, `prepend` for flexible content editing
+- ✅ Tag management: add, remove, and list tags in notes
 - ✅ Safe deletion with confirmation requirement to prevent accidents
 - ✅ Automatic path trimming to handle whitespace in inputs
 - ✅ TypeScript support with Node.js runtime (using tsx for execution)
 - ✅ Comprehensive error handling and validation
+- ✅ **Performance optimized**: No unnecessary token consumption, efficient for large vaults
+- ✅ **Zero dependencies**: No Obsidian plugins required, works with any vault structure
+- ✅ **Intelligent link handling**: Smart processing of internal links and references
 
 ## Prerequisites
 
@@ -104,6 +126,15 @@ npm install
 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
+
+# Test with any vault
+mcp-inspector npx @mauricio.wolff/mcp-obsidian@latest /path/to/your/vault
+```
+
 ## Usage
 
 ### Running the Server
@@ -216,6 +247,7 @@ claude mcp add obsidian --scope user npx @mauricio.wolff/mcp-obsidian /path/to/y
 **Confirmed MCP Support:**
 - **IntelliJ IDEA 2025.1+** - Native MCP client support
 - **Cursor IDE** - Built-in MCP compatibility
+- **Windsurf IDE** - Full MCP integration
 - **Zed, Replit, Codeium, Sourcegraph** - In development
 - **Microsoft Copilot Studio** - Native MCP support with one-click server connections
 
@@ -238,6 +270,12 @@ Most modern MCP clients use similar JSON configuration patterns. Refer to your s
 - "List all markdown files in my 'Projects' folder"
 - "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"
+- **Smart Tagging**: "Review my untagged notes and suggest appropriate tags based on content"
+
 ## Troubleshooting
 
 ### Common Issues
@@ -685,6 +723,7 @@ This MCP server implements several security measures to protect your Obsidian va
 - `src/frontmatter.ts` - YAML frontmatter handling with gray-matter
 - `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/types.ts` - TypeScript type definitions
 
 ## Contributing
@@ -697,4 +736,4 @@ This MCP server implements several security measures to protect your Obsidian va
 
 ## License
 
-MIT
+MIT

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mauricio.wolff/mcp-obsidian",
-  "version": "0.5.4",
-  "description": "Lightweight MCP server for safe Obsidian vault access",
+  "version": "0.5.5",
+  "description": "Universal AI bridge for Obsidian vaults - connect any MCP-compatible assistant",
   "author": "bitbonsai",
   "license": "MIT",
   "type": "module",
@@ -47,12 +47,19 @@
     "mcp",
     "obsidian",
     "model-context-protocol",
+    "universal",
+    "ai-bridge",
+    "mcp-server",
     "claude",
+    "chatgpt",
     "ai",
-    "node",
-    "filesystem",
-    "frontmatter",
-    "yaml"
+    "knowledge-management",
+    "pkm",
+    "vault",
+    "notes",
+    "markdown",
+    "future-proof",
+    "open-standard"
   ],
   "publishConfig": {
     "access": "public"