claude-faf-mcp 3.2.1 → 3.3.1

package/CHANGELOG.md

@@ -5,6 +5,46 @@ 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.1] - 2025-11-12
+
+### Changed
+- **README Simplification** - Minimalist Quick Start following Claude Code's clean approach
+  - "Copy and paste this to Claude/your AI" - Zero friction installation
+  - Single-line config instruction (no verbose JSON blocks)
+  - npm as primary install method (traffic/discovery optimized)
+  - Desktop Extension as one-click alternative
+- **Strategic Positioning** - Optimized for npm search ranking and discoverability
+  - Removed Projects Convention section (moved to docs)
+  - Removed Troubleshooting section (moved to docs)
+  - Clean, professional landing page
+
+### User Experience
+This release perfects the installation messaging: users get ultra-minimal instructions while we maintain maximum npm download metrics for ecosystem discoverability.
+
+## [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

@@ -6,7 +6,7 @@
   </div>
 </div>
 
-> Official MCP server for FAF (Foundational AI-context Format) with 50 tools - Persistent project context that integrates seamlessly with Claude Desktop workflows
+> Official MCP server for .FAF (Foundational AI-context Format) with 50 tools - Persistent project context that integrates seamlessly with Claude Desktop workflows
 
 [![NPM Downloads](https://img.shields.io/npm/dt/claude-faf-mcp?label=total%20downloads&color=00CCFF)](https://www.npmjs.com/package/claude-faf-mcp)
 [![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?logo=discord&logoColor=white)](https://discord.com/invite/3pjzpKsP)
@@ -52,94 +52,11 @@ At 55% you are building your project with half a blueprint and basically flippin
 
 ## ⚡ Quick Start
 
-**⚠️ INSTALLATION ORDER REQUIRED:**
+**Copy and paste this to Claude/your AI:**
 
-**Step 1: Install CLI First (Required)**
-```bash
-npm install -g faf-cli
-```
-
-**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.
-
-**Claude Desktop Configuration:**
-```json
-{
-  "mcpServers": {
-    "faf": {
-      "command": "npx",
-      "args": ["-y", "claude-faf-mcp"]
-    }
-  }
-}
-```
-
----
-
-## 📁 Projects Convention
-
-**Default Path Structure:** `~/Projects/[project-name]/project.faf`
-
-The MCP server uses an intelligent path resolution system:
-
-1. **AI Inference** - Automatically detects project name from README titles, package.json, or uploaded files
-2. **User Statement** - Explicit project name provided by user
-3. **Custom Path** - User-provided path always wins
-
-**Example Workflows:**
-
-```bash
-# Upload README titled "Heritage Club Dubai"
-# → Automatically creates: ~/Projects/heritage-club-dubai/project.faf
-
-# Provide project name
-faf_init projectName:"my-app"
-# → Creates: ~/Projects/my-app/project.faf
-
-# Explicit path (always respected)
-faf_init path:"/Users/you/custom/location"
-# → Creates: /Users/you/custom/location/project.faf
-```
-
-**Cross-Platform Support:**
-- macOS: `~/Projects/`
-- Linux: `~/Projects/`
-- Windows: `%USERPROFILE%\Projects\`
-
-**Guide Tool:**
-Run `faf_guide` in Claude Desktop for complete path resolution rules and UX patterns.
-
----
-
-## 🔧 Troubleshooting
-
-**CLI Not Detected?**
-
-The MCP auto-detects faf-cli in common locations. If detection fails, set the path manually:
-
-```json
-{
-  "mcpServers": {
-    "faf": {
-      "command": "npx",
-      "args": ["-y", "claude-faf-mcp"],
-      "env": {
-        "FAF_CLI_PATH": "/custom/path/to/faf"
-      }
-    }
-  }
-}
-```
+> Install the FAF MCP server: `npm install -g claude-faf-mcp`, then add this to my claude_desktop_config.json: `{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "claude-faf-mcp"]}}}` and restart Claude Desktop.
 
-Find your CLI path: `which faf`
+**One-Click Alternative:** [Desktop Extension (.mcpb)](https://github.com/Wolfe-Jam/claude-faf-mcp/releases/latest)
 
 ---
 
@@ -199,7 +116,7 @@ Find your CLI path: `which faf`
 
 ## 🏆 Why FAF?
 
-> "README for the AI era" — Gemini CLI
+> "README for the AI era" — Gemini CLI 
 
 **Persistent Context** - Your project's DNA lives in `project.faf`, readable by any AI or human
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-faf-mcp",
-  "version": "3.2.1",
+  "version": "3.3.1",
   "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"
   },