diff --git a/README.md b/README.md index 06207c1..a83da47 100644 --- a/README.md +++ b/README.md @@ -17,18 +17,14 @@ This plugin connects your Obsidian vault to AI assistants through MCP (Model Con - Claude Code/Continue.dev (VS Code) - Any platform that supports local MCP servers -## Why Semantic MCP? - -Traditional file access gives AI a narrow view - one document at a time. This plugin transforms that into **semantic agency**: - -- **Graph Navigation**: AI follows links between notes, understanding relationships and context -- **Concept Discovery**: Semantic search finds related ideas across your vault -- **Contextual Awareness**: AI understands where information lives in your knowledge structure -- **Intelligent Synthesis**: Combine fragments from multiple notes to answer complex questions - ## Quick Start -**Prerequisites:** You need an MCP-compatible AI client like Claude Desktop, Claude Code, or Continue.dev. +**Prerequisites:** an MCP-compatible AI client like Claude Desktop, Claude Code, or Continue.dev. + +> ## πŸ“¦ ──drag──▢ πŸ€–πŸ’¬ +> **Download the `.mcpb` bundle from the plugin's config page β†’ drag it onto Claude Desktop β†’ paste your key. Done.** + +For most people that's the entire setup. The numbered steps below spell it out, then cover other MCP clients. ### 1. Install the Plugin @@ -45,9 +41,9 @@ Traditional file access gives AI a narrow view - one document at a time. This pl Three onboarding paths, ordered by audience. All three are also shown in the plugin's Settings tab with copy-ready values. -**Claude Desktop β€” one-click `.mcpb` install (recommended)** +**πŸ“¦ β†’ πŸ€– Claude Desktop β€” one-click `.mcpb` install (recommended)** -Download `obsidian-mcp-.mcpb` from the [latest release](https://github.com/aaronsb/obsidian-mcp-plugin/releases/latest), then either drag it onto the Claude Desktop window or double-click it. Claude Desktop opens an install dialog with two fields β€” paste the URL and API key shown in the plugin's Settings tab, hit Save, and you're done. +Download `obsidian-mcp-.mcpb` β€” either from the plugin's **Settings** tab (button right on the config page) or the [latest release](https://github.com/aaronsb/obsidian-mcp-plugin/releases/latest) β€” then either drag it onto the Claude Desktop window or double-click it. Claude Desktop opens an install dialog with two fields β€” paste the URL and API key shown in the plugin's Settings tab, hit Save, and you're done. > *Cross-platform note:* `.mcpb` files install via Claude Desktop's bundled handler. If double-click doesn't trigger Claude on your system, drag the file onto Claude Desktop's window instead, or right-click β†’ "Open with…" and pick Claude Desktop (then "always open with" if your OS asks). Behavior varies by platform: macOS usually auto-associates, Windows may need a one-time association, Linux varies by desktop environment. @@ -134,6 +130,15 @@ Your AI assistant now has these capabilities: - Work with Dataview queries (if installed) - Manage Obsidian Bases (database views) +## Why Semantic MCP? + +Traditional file access gives AI a narrow view - one document at a time. This plugin transforms that into **semantic agency**: + +- **Graph Navigation**: AI follows links between notes, understanding relationships and context +- **Concept Discovery**: Semantic search finds related ideas across your vault +- **Contextual Awareness**: AI understands where information lives in your knowledge structure +- **Intelligent Synthesis**: Combine fragments from multiple notes to answer complex questions + ## Core Tools The plugin provides 8 semantic tool groups that give AI comprehensive vault access: