From 7c1774bcbe9f86f69302403dec6fa596256e48a0 Mon Sep 17 00:00:00 2001 From: Aaron Bockelie Date: Fri, 3 Jul 2026 23:01:25 -0500 Subject: [PATCH] docs(readme): lead with concrete verbs + the native/no-server edge MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Repositioning the README opening after a competitive prose analysis of the top Obsidian-MCP projects. The old opening led with an abstract tagline ("Give AI semantic agency over your knowledge graph") and spent prime real estate explaining what MCP is — to people who searched for MCP — while our single biggest differentiator (a native in-Obsidian server, no external Node process, no separate REST-API plugin) went unstated. A competitor was already using our own "no external dependencies" angle. Changes to the top-of-README positioning only (setup/tools/docs untouched): - Verb-first tagline: "Read, write, search, and traverse your Obsidian vault from any AI assistant — through an MCP server that runs inside Obsidian." - State the native/no-server edge in the first sentence, framed positively (our own architecture, not a competitor put-down); connect it to why the drag-drop `.mcpb` setup is possible. - Ground the "8 semantic tools" claim with a concrete, verified example (the vault tool alone handles 13 actions) instead of an abstraction. - Relocate the "what is MCP" explainer to a short "New to MCP?" aside. - Preserve the drag-drop onboarding hero — the strongest story in the field. --- README.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index a83da47..42e3d7a 100644 --- a/README.md +++ b/README.md @@ -8,14 +8,15 @@ 📦 **[Available in the Obsidian Community Plugin directory →](https://community.obsidian.md/plugins/semantic-vault-mcp)** -**Give AI semantic agency over your knowledge graph** +**Read, write, search, and traverse your Obsidian vault from any AI assistant — through an MCP server that runs _inside_ Obsidian.** -This plugin connects your Obsidian vault to AI assistants through MCP (Model Context Protocol), giving them the ability to understand and navigate your notes as a connected knowledge graph, not just isolated files. Through semantic hints and graph traversal, AI gains the agency to explore concepts, follow connections, and synthesize information across your entire vault. +No external Node process to launch, no separate REST-API plugin to bridge through: the server *is* the plugin. Setup is a drag-and-drop — drop the `.mcpb` bundle onto Claude Desktop, paste your key, done. -**MCP (Model Context Protocol)** is the open standard that lets AI assistants interact with external tools and data sources. This plugin works with any MCP-compatible client including: -- Claude Desktop (Anthropic) -- Claude Code/Continue.dev (VS Code) -- Any platform that supports local MCP servers +It exposes **8 semantic tools** — each one a family of operations rather than a single call (the `vault` tool alone handles 13: list, read, create, search, move, split, combine, and more) — plus Dataview queries, Bases, and graph traversal. So the AI can follow links, tags, and backlinks and synthesize across your whole vault as a connected knowledge graph, not one open file at a time. + +**Works with any MCP-compatible client** — Claude Desktop, Claude Code, Cline, Continue.dev, and anything that speaks local MCP. + +> **New to MCP?** The [Model Context Protocol](https://modelcontextprotocol.io) is the open standard that lets AI assistants interact with external tools and data. You don't need to understand it to use this — the [Quick Start](#quick-start) is three steps. ## Quick Start