npm - claude-faf-mcp - Versions diffs - 2.2.7 → 2.2.9 - Mend

claude-faf-mcp 2.2.7 → 2.2.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/README.md +62 -242
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,115 +1,70 @@
-# 🏎️⚡️ Claude .faf MCP Server
-## F1-Inspired AI Context Management for Planet Claude
+# 🏎️⚡️ claude-faf-mcp
-> **🏆 MCP READY - The JPEG for AI is REAL! 🏆**
+## .faf The JPEG for AI™ - Universal AI Context Management
-> **🏁 F1-Inspired TESTING CENTER: [`/Users/wolfejam/faf-test-environment`](https://github.com/wolfejam/claude-faf-mcp/blob/main/WOLFEJAM_TESTING_CENTER.md) | [View Dashboard](file:///Users/wolfejam/FAF/claude-faf-mcp/TESTING_CENTER_DASHBOARD.html) 🏁**
+> **MCP Compatible | Zero Dependencies | Production Ready**
-> **Claude .faf MCP Server | AI-Context on-demand management with bi-sync for Claude Users of all levels, with C.O.R.E performance faf-engine-Mk1**
+Transform your projects into AI-optimized collaboration spaces with championship-grade performance.
-Transform your projects into AI-optimized collaboration spaces with **C.O.R.E (Comprehensive, Optimized, Relentless, Empirical) performance** powered by the **faf-engine-Mk1** architecture.
-[![MCP Compatible](https://img.shields.io/badge/MCP-✅%20Protocol%20Compatible-green)](https://modelcontextprotocol.io)
 [![NPM Version](https://img.shields.io/npm/v/claude-faf-mcp)](https://www.npmjs.com/package/claude-faf-mcp)
-[![Claude Desktop](https://img.shields.io/badge/Claude-Desktop%20Ready-purple)](https://claude.ai)
-[![AI Readiness](https://img.shields.io/badge/AI%20Readiness-99%25-orange)](https://faf.one)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Strict%20Mode-blue)](https://www.typescriptlang.org/)
-[![F1-Inspired](https://img.shields.io/badge/Philosophy-F1--Inspired-red)](https://github.com/faf-dev/claude-faf-mcp)
+[![Downloads](https://img.shields.io/npm/dt/claude-faf-mcp)](https://www.npmjs.com/package/claude-faf-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 ## 🚨 ZERO DEPENDENCIES, ZERO FAFF™
-**11,000+ tests run** • **240+ npm downloads** • **<50ms operations**
-## 🍊 ZERO .faf | .fafLESS AI
-**We ARE the C in MCP.** Vitamin Context for healthy AI. I⚡🍊
+**Production v2.2.8** • **11,000+ tests run** • **<50ms operations** • **1 dependency only**
-## 🚀 Quick Install (2 Commands!)
+## 🚀 Quick Install
 ```bash
-# Step 1: Install globally
+# Install globally
 npm install -g claude-faf-mcp
-# Step 2: Add to Claude Desktop
+# Add to Claude Desktop
 echo '{"mcpServers":{"claude-faf-mcp":{"command":"claude-faf-mcp","args":[],"env":{}}}}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json
 ```
-**Step 3:** Restart Claude Desktop - DONE! 🏁
-**Test:** Drop any package.json into Claude and watch the magic!
-## 🤖 What is Claude FAF MCP?
-The **Claude FAF MCP Server** provides 33 honest file operations for Claude Desktop. **ENJOY this in Desktop - FAF CLI will be right behind it!**
-Currently delivers:
-- ✅ Native file operations (read, write, list, etc.)
-- ✅ <50ms performance guaranteed
-- ✅ Works WITHOUT external dependencies
-- 🔜 Full FAF CLI integration coming soon for scoring & enhancement
-### 💡 PRO TIP: The Perfect Workflow
-**Drop a project file → Instant context!** Here's the flow:
-1. Drop your `package.json`, `requirements.txt`, or `README.md` into Claude
-2. Claude instantly knows what you're working on
-3. For new projects: Claude creates `claude.md`, you create `.faf`
-4. The AI-Context becomes **permanent glue** - your project understanding persists!
-*"Once you drop that first file, the context sticks. No more explaining your project every chat!"*
-### Key Benefits
-- 🧠 **Intelligent Context**: Automatically analyzes and optimizes your project for AI collaboration
-- ⚡ **Real-time Sync**: Bi-directional synchronization between `.faf` context and `claude.md`
-- 📈 **AI Scoring**: Get detailed metrics on your project's AI-readiness
-- 🎯 **Claude-Optimized**: Specially tuned for optimal Claude performance
-- 🌐 **Universal**: Works with Claude Desktop, Claude Web, and Claude API
-## 💭 The World's First AI-Validated Developer Tool?
+Restart Claude Desktop - Done! 🏁
-### What the BIG-3 AI's themselves Say:
+## 🤖 What is claude-faf-mcp?
-| Platform | Score | Verdict |
-|----------|-------|---------|
-| **Claude (Anthropic)** | 9.5/10 | *"Should become the standard"* |
-| **OpenAI Codex** | 9/10 | *"Every project should have one"* |
-| **Google Gemini** | 9.5/10 | *"README evolution for AI era"* |
+The MCP server that brings .faf format power to Claude Desktop. Drop any project file into Claude and get instant AI understanding.
-> **"its so logical [.faf] if it didn't exist, AI would have built it itself"** - Claude Code
+### Key Features
-> **"package.json gives me a list of dependencies, .faf shows me what to do with them"** - Claude Code
+- ✅ **Zero Configuration** - Works instantly
+- ✅ **33+ Tools** - Complete file operations
+- ✅ **<50ms Performance** - F1-inspired speed
+- ✅ **Bi-directional Sync** - .faf ↔ claude.md
+- ✅ **99% AI Readiness** - Guaranteed understanding
-> **"package.json wasn't built for this, .faf was"** - .faf Inventor
-## 🏁 Testing & Development
-**📝 Testing Guide: [TESTING_CENTER.md](./TESTING_CENTER.md)**
-**🧪 Test Scripts: Available in `/tests/scripts/`**
-### Quick Test Commands
-```bash
-# Test the MCP server
-npm test
+## 🛠️ Available Tools
-# Build the project
-npm run build
-```
+### Core Tools
+- `faf_init` - Initialize .faf context
+- `faf_score` - Calculate AI readiness score
+- `faf_status` - Get project status
-## 🚀 Quick Start
+### Enhancement Tools
+- `faf_enhance` - Claude-optimized enhancement
+- `faf_sync` - Sync .faf with claude.md
+- `faf_bi_sync` - Real-time bidirectional sync
-### Prerequisites
+### Management Tools
+- `faf_trust` - Validate context integrity
+- `faf_clear` - Clear caches
+- `faf_debug` - Debug connectivity
-- Node.js 18+
+## 📖 Usage
-### Installation
+1. **Drop a file** - Drop package.json, README, or any project file into Claude
+2. **Instant context** - Claude immediately understands your project
+3. **Use tools** - Type "faf" to see available commands
+4. **Stay synced** - Context persists across conversations
-```bash
-npm install -g claude-faf-mcp
-```
+## ⚙️ Configuration
-### Configuration
-Add to your Claude Desktop configuration (`claude_desktop_config.json`):
+Add to Claude Desktop configuration:
 ```json
 {
@@ -122,185 +77,50 @@ Add to your Claude Desktop configuration (`claude_desktop_config.json`):
 }
 ```
-Or for development with a local FAF build:
+## 📊 Real Metrics
-```json
-{
-  "mcpServers": {
-    "claude-faf": {
-      "command": "claude-faf-mcp",
-      "args": [
-        "--transport", "stdio",
-        "--faf-engine", "/path/to/your/faf/cli"
-      ]
-    }
-  }
-}
 ```
-## 🛠️ Available Tools
-The server provides 9 powerful tools for AI-enhanced development:
-### Core Analysis
-- **`faf_status`** - Get comprehensive project status and AI readiness metrics
-- **`faf_score`** - Calculate AI collaboration score with detailed breakdown
-- **`faf_debug`** - Debug server environment and FAF CLI connectivity
-### Project Management
-- **`faf_init`** - Initialize FAF context with intelligent stack detection
-- **`faf_trust`** - Validate context integrity and trust metrics
-- **`faf_clear`** - Clear caches and reset state
-### Context Optimization
-- **`faf_enhance`** - Claude-optimized AI enhancement with multi-model support
-- **`faf_sync`** - Synchronize .faf context with claude.md
-- **`faf_bi_sync`** - Bi-directional sync with real-time watching
-## 📖 Usage Examples
-### Initialize a New Project
-```
-Use the faf_init tool to set up FAF context for your project.
+📈 Status: PRODUCTION
+├─ 💎 Version: 2.2.8
+├─ 🚀 Performance: <50ms
+├─ 📦 Dependencies: 1 (MCP SDK only)
+├─ 🧪 Tests Run: 11,000+
+└─ 🏆 AI Readiness: 99%
 ```
-### Check Project Health
+## 🏁 Development
-```
-Use faf_status to see your project's AI collaboration metrics:
-- Context quality score
-- AI readiness level
-- Performance metrics
-- Claude compatibility rating
-```
-### Optimize for Claude
-```
-Use faf_enhance with model="claude" and focus="claude-optimal"
-to get the best possible Claude collaboration experience.
-```
-### Sync with Claude.md
-```
-Use faf_bi_sync to maintain automatic synchronization between
-your .faf context and claude.md file for seamless collaboration.
-```
-## ⚙️ Configuration Options
-The server accepts several command-line options:
-- `--transport <stdio|http-sse>` - Transport protocol (default: stdio)
-- `--port <number>` - Port for HTTP-SSE transport (default: 3001)
-- `--faf-engine <path>` - Path to FAF CLI (default: 'faf' global command)
-- `--debug` - Enable debug logging
-## 🏗️ Development Setup
-### Local Development
-1. Clone and install dependencies:
 ```bash
-git clone https://github.com/faf-dev/claude-faf-mcp.git
+# Clone repo
+git clone https://github.com/wolfejam/claude-faf-mcp.git
 cd claude-faf-mcp
-npm install
-```
-2. Build the project:
-```bash
+# Install & build
+npm install
 npm run build
-```
-3. Test locally:
-```bash
-npm run dev:stdio
-```
-4. Add to Claude config with local path:
-```json
-{
-  "mcpServers": {
-    "claude-faf-dev": {
-      "command": "npx",
-      "args": ["ts-node", "src/cli.ts", "--transport", "stdio"],
-      "cwd": "/path/to/claude-faf-mcp"
-    }
-  }
-}
-```
-### Testing
-Run the test suite:
-```bash
+# Test
 npm test
 ```
-Test MCP protocol compliance:
-```bash
-npm run test:mcp
-```
 ## 📋 Requirements
-- **Node.js**: Version 18 or higher
-- **FAF CLI**: Installed and accessible in PATH
-- **Claude Desktop**: Latest version with MCP support
-- **Operating System**: macOS, Linux, or Windows
-## 📊 Real Performance Metrics
-```
-📈 Project Status: CHAMPION
-├─ 💎 Context Quality: 100%
-├─ 🤖 AI Readiness: Universal
-├─ ⚡ Performance: 38ms average
-├─ 🧡 Community: Growing daily
-└─ 📈 Enterprise Ready: Day One
-```
-## 🏁 The F1-Inspired Philosophy
-We build software with F1-Inspired principles:
-1. **Precision Engineering** - Every line purposeful
-2. **Performance Obsession** - Milliseconds matter
-3. **Continuous Innovation** - Always improving
-4. **Championship Standards** - Only the best survives
-*Created by 🏎️⚡️wolfejam, F1-fanatic and inventor of .faf*
-## 🤝 Contributing
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
-1. Fork the repository
-2. Create a feature branch: `git checkout -b feature/amazing-feature`
-3. Commit your changes: `git commit -m 'Add amazing feature'`
-4. Push to the branch: `git push origin feature/amazing-feature`
-5. Open a Pull Request
+- Node.js 18+
+- Claude Desktop (latest)
+- macOS, Linux, or Windows
 ## 📄 License
-MIT License - see the [LICENSE](LICENSE) file for details.
+MIT License - see LICENSE file
-## 🙋 Support
+**Note**: The .faf-Engine(s) are proprietary and available under license.
-- **GitHub Issues**: [Report bugs or request features](https://github.com/faf-dev/claude-faf-mcp/issues)
-- **Documentation**: [Full documentation](https://faf.dev/docs/claude-mcp)
-- **Community**: [Join our Discord](https://discord.gg/faf-dev)
+## 🔗 Links
-## 🔗 Related Projects
-- **[FAF CLI](https://www.npmjs.com/package/faf-cli)** - The core FAF engine
-- **[Claude Desktop](https://claude.ai/download)** - Anthropic's desktop application
-- **[MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk)** - Model Context Protocol SDK
+- **NPM**: [claude-faf-mcp](https://www.npmjs.com/package/claude-faf-mcp)
+- **Website**: [faf.one](https://faf.one)
+- **Support**: support@faf.one
 ---
-**Made with ❤️ for the Claude community**
-Transform your projects into AI-collaboration powerhouses with Claude FAF MCP Server!
+**Made with 🧡 by wolfejam** | **ZERO DEPENDENCIES, ZERO FAFF™**

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "claude-faf-mcp",
-  "version": "2.2.7",
+  "version": "2.2.9",
   "description": ".faf The JPEG for AI is here. The C in MCP is .faf - Foundational AI-context Format. Universal AI context management with 33+ tools for Claude Desktop. Every command shows AI-Readiness score. Drop file → Type 'faf' → 99% ready!",
   "main": "dist/server.js",
   "bin": {