@blacksmithers/vaultforge 1.0.0 → 1.0.2

package/README.md

@@ -21,7 +21,7 @@
   <a href="#smart-search">Search</a> ·
   <a href="#vault-intelligence">Intelligence</a> ·
   <a href="#all-tools">All 27 Tools</a> ·
-  <a href="#quick-start">Quick Start</a>
+  <a href="#install">Install</a>
 </p>
 
 ---
@@ -267,62 +267,85 @@ The vault maps itself.
 
 ---
 
-## Quick Start
+## Install
 
 ### Prerequisites
 
-- [Node.js](https://nodejs.org/) v22+
 - A folder with Markdown files (Obsidian vault or any structure)
+- One of: [Claude Desktop](https://claude.ai/download), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [VS Code](https://code.visualstudio.com/), [Cursor](https://cursor.com/), [Windsurf](https://windsurf.com/), or any MCP-compatible client
+- [Node.js](https://nodejs.org/) v22+ (not required for `.mcpb` one-click install)
 
 **Obsidian app is not required.** VaultForge operates directly on the filesystem. If Obsidian is open, it picks up changes in real time.
 
-### Install
+### Claude Desktop (one-click)
 
+**Windows** — [⬇ Download vaultforge.mcpb](https://github.com/blacksmithers/vaultforge/releases/latest/download/vaultforge.mcpb) — open the file, enter your vault path, done.
+
+**macOS:**
 ```bash
-npm install -g @blacksmithers/vaultforge
+curl -fsSL https://github.com/blacksmithers/vaultforge/releases/latest/download/vaultforge.mcpb -o /tmp/vaultforge.mcpb && open /tmp/vaultforge.mcpb
 ```
 
-### Configure
+**Linux:**
+```bash
+curl -fsSL https://github.com/blacksmithers/vaultforge/releases/latest/download/vaultforge.mcpb -o /tmp/vaultforge.mcpb && xdg-open /tmp/vaultforge.mcpb
+```
 
-**Claude Desktop** — edit `claude_desktop_config.json`:
+### Claude Code
 
-| OS | Config file location |
-|----|---------------------|
-| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
-| Linux | `~/.config/Claude/claude_desktop_config.json` |
+```bash
+claude mcp add vaultforge -- npx -y @blacksmithers/vaultforge /path/to/your/vault
+```
+
+### VS Code / Cursor / Windsurf
 
-> **Tip (Windows):** press `Win+R`, paste `%APPDATA%\Claude`, hit Enter. The folder opens directly.
+Add to your MCP settings JSON (`.vscode/mcp.json`, `.cursor/mcp.json`, or equivalent):
 
-macOS / Linux:
 ```json
 {
-  "mcpServers": {
+  "servers": {
     "vaultforge": {
-      "command": "vaultforge",
-      "args": ["/Users/you/Documents/MyVault"]
+      "command": "npx",
+      "args": ["-y", "@blacksmithers/vaultforge", "/path/to/your/vault"]
     }
   }
 }
 ```
 
-Windows:
+### Any MCP client
+
+Use this universal pattern — any client that supports MCP stdio transport will work:
+
+- **Command:** `npx`
+- **Args:** `["-y", "@blacksmithers/vaultforge", "/path/to/your/vault"]`
+
+<details>
+<summary>Global install + manual Claude Desktop config</summary>
+
+```bash
+npm install -g @blacksmithers/vaultforge
+```
+
+Edit `claude_desktop_config.json`:
+
+| OS | Config file location |
+|----|---------------------|
+| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
+| Linux | `~/.config/Claude/claude_desktop_config.json` |
+
 ```json
 {
   "mcpServers": {
     "vaultforge": {
       "command": "vaultforge",
-      "args": ["C:\\Users\\you\\Documents\\MyVault"]
+      "args": ["/path/to/your/vault"]
     }
   }
 }
 ```
 
-**Claude Code:**
-
-```bash
-claude mcp add vaultforge -- vaultforge /path/to/your/vault
-```
+</details>
 
 ### Verify
 

package/manifest.json

@@ -0,0 +1,35 @@
+{
+  "manifest_version": "0.3",
+  "name": "@blacksmithers/vaultforge",
+  "version": "1.0.2",
+  "description": "Blazing-fast local MCP server for Obsidian vault operations via stdio",
+  "author": {
+    "name": "Solutions Forge LTDA",
+    "url": "https://solutionsforge.tech"
+  },
+  "icon": "assets/icon.png",
+  "server": {
+    "type": "node",
+    "entry_point": "dist/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": [
+        "${__dirname}/dist/index.js",
+        "${user_config.vault_path}"
+      ]
+    }
+  },
+  "user_config": {
+    "vault_path": {
+      "type": "string",
+      "title": "Vault Path",
+      "description": "Absolute path to your Obsidian vault (e.g. /Users/you/Documents/MyVault)",
+      "required": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blacksmithers/vaultforge.git"
+  },
+  "license": "MIT"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blacksmithers/vaultforge",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Blazing-fast local MCP server for Obsidian vault operations via stdio",
   "type": "module",
   "bin": {
@@ -11,6 +11,8 @@
   },
   "files": [
     "dist",
+    "manifest.json",
+    "assets/icon.png",
     "README.md",
     "LICENSE"
   ],