claude-faf-mcp 3.2.1 → 3.3.0

package/CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to claude-faf-mcp will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.3.0] - 2025-11-12
+
+### Added
+- **Desktop Extension (.mcpb)** - One-click installation bundle with branded FAF orange icon
+  - Packaged .mcpb format for drag-and-drop installation in Claude Desktop
+  - Orange smiley icon displays in all MCP server views
+  - Available from GitHub releases page
+- **MCP Protocol Icons** - Added full icon set (48x48, 128x128, 256x256, 512x512) to server.json
+  - Icons hosted on GitHub raw URLs for registry display
+  - Proper MIME types and size specifications
+
+### Changed
+- **One-Command Installation** - Moved faf-cli from peerDependencies to dependencies
+  - `npm install -g claude-faf-mcp` now auto-installs both packages
+  - Dual download metrics maintained (both packages counted separately)
+  - Eliminated manual two-step installation process
+- **README Restructure** - Added two installation options
+  - Option 1: npm (one command, no config editing)
+  - Option 2: Desktop Extension (with branded icon)
+  - Clear documentation of path resolution system
+
+### Installation Experience
+This release perfects the installation flow: users get one-command simplicity while we maintain accurate download metrics for both claude-faf-mcp and faf-cli packages.
+
 ## [3.2.0] - 2025-11-10
 
 ### Added

package/README.md

@@ -52,25 +52,17 @@ At 55% you are building your project with half a blueprint and basically flippin
 
 ## ⚡ Quick Start
 
-**⚠️ INSTALLATION ORDER REQUIRED:**
+### Option 1: npm (One Command 🚀)
 
-**Step 1: Install CLI First (Required)**
-```bash
-npm install -g faf-cli
-```
+**One command installs everything:**
 
-**Step 2: Then Install MCP Server**
 ```bash
-# Via npx (recommended - always latest)
-npx @modelcontextprotocol/inspector npx -y claude-faf-mcp
-
-# Or install globally
 npm install -g claude-faf-mcp
 ```
 
-**Why this order?** MCP auto-detects CLI at startup. Installing MCP first will show warnings. Always install faf-cli before claude-faf-mcp.
+That's it! Auto-installs faf-cli + MCP server. Both get download metrics.
 
-**Claude Desktop Configuration:**
+**Configure Claude Desktop:**
 ```json
 {
   "mcpServers": {
@@ -82,6 +74,34 @@ npm install -g claude-faf-mcp
 }
 ```
 
+Restart Claude Desktop and you're ready!
+
+---
+
+### Option 2: Desktop Extension (With Icon 🧡)
+
+**Get the FAF orange icon in Claude Desktop!**
+
+**Step 1: Install CLI**
+```bash
+npm install -g faf-cli
+```
+
+**Step 2: Install Desktop Extension**
+1. **Download** the `.mcpb` file:
+   https://github.com/Wolfe-Jam/claude-faf-mcp/releases/latest
+
+2. **Install in Claude Desktop:**
+   - Settings → Extensions → Advanced settings
+   - Click "Install Extension"
+   - Select `claude-faf-mcp-v3.2.1.mcpb`
+   - Restart Claude Desktop
+
+3. **Verify the FAF orange icon** shows in your MCP list!
+
+**Why this is easier:** No config file editing, auto-detects CLI, branded icon everywhere.
+
+
 ---
 
 ## 📁 Projects Convention

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-faf-mcp",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "mcpName": "io.github.Wolfe-Jam/claude-faf-mcp",
   "description": "IANA-registered format (application/vnd.faf+yaml) • Persistent project context • MCP server for Claude Desktop • MIT License",
   "icon": "./assets/icons/faf-icon-256.png",
@@ -119,10 +119,8 @@
   "publishConfig": {
     "access": "public"
   },
-  "peerDependencies": {
-    "faf-cli": ">=3.1.1"
-  },
   "dependencies": {
+    "faf-cli": ">=3.1.1",
     "@modelcontextprotocol/sdk": "^1.20.1",
     "yaml": "^2.4.1"
   },