Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (claude-faf-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🏎️⚡️ claude-faf-mcp

.faf The JPEG for AI™ - Universal AI Context Management

MCP Compatible | Zero Dependencies | Production Ready

Transform your projects into AI-optimized collaboration spaces with championship-grade performance.

🚨 ZERO DEPENDENCIES, ZERO FAFF™

Production v2.2.8 • 11,000+ tests run • <50ms operations • 1 dependency only

🚀 Quick Install

# Install globally
npm install -g claude-faf-mcp

# Add to Claude Desktop
echo '{"mcpServers":{"claude-faf-mcp":{"command":"claude-faf-mcp","args":[],"env":{}}}}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

Restart Claude Desktop - Done! 🏁

🤖 What is claude-faf-mcp?

The MCP server that brings .faf format power to Claude Desktop. Drop any project file into Claude and get instant AI understanding.

Key Features

✅ 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

🛠️ Available Tools

Core Tools

faf_init - Initialize .faf context
faf_score - Calculate AI readiness score
faf_status - Get project status

Enhancement Tools

faf_enhance - Claude-optimized enhancement
faf_sync - Sync .faf with claude.md
faf_bi_sync - Real-time bidirectional sync

Management Tools

faf_trust - Validate context integrity
faf_clear - Clear caches
faf_debug - Debug connectivity

📖 Usage

Drop a file - Drop package.json, README, or any project file into Claude
Instant context - Claude immediately understands your project
Use tools - Type "faf" to see available commands
Stay synced - Context persists across conversations

⚙️ Configuration

Add to Claude Desktop configuration:

{
  "mcpServers": {
    "claude-faf": {
      "command": "claude-faf-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

📊 Real Metrics

📈 Status: PRODUCTION
├─ 💎 Version: 2.2.8
├─ 🚀 Performance: <50ms
├─ 📦 Dependencies: 1 (MCP SDK only)
├─ 🧪 Tests Run: 11,000+
└─ 🏆 AI Readiness: 99%

🏁 Development

# Clone repo
git clone https://github.com/wolfejam/claude-faf-mcp.git
cd claude-faf-mcp

# Install & build
npm install
npm run build

# Test
npm test

📋 Requirements

Node.js 18+
Claude Desktop (latest)
macOS, Linux, or Windows

📄 License

MIT License - see LICENSE file

Note: The .faf-Engine(s) are proprietary and available under license.

🔗 Links

NPM: claude-faf-mcp
Website: faf.one
Support: support@faf.one

Made with 🧡 by wolfejam | ZERO DEPENDENCIES, ZERO FAFF™