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 v2.4.0 | .faf Project DNA for ANY AI ✨

🧡 Orange Smiley MCP for Claude Desktop

100% FREE Forever • Zero Setup • 33+ Tools • 1,600+ Weekly Downloads

Join the Community • Report Issues

🌟 Join Our Growing Community!

💬 New Community Hub at github.com/Wolfe-Jam/faf/discussions

.faf Project DNA for ANY AI ✨ [Foundational AI-context Format]

Universal, shareable AI-Context for any AI, human or team, regardless of size, location, languages, stack, setup or documentation.

Add a .faf file to your repo and watch Claude, ChatGPT, Gemini, or any AI tool understand your entire codebase with speed and precision.

🎉 1,600 WEEKLY DOWNLOADS AND CLIMBING! 🎉

Have you been dot.faffed yet? 🧡⚡️ Universal AI Context • 33+ Tools • Real-time Scoring

claude-faf-mcp - MCP Implementation 🧡⚡️

MCP SDK for Protocol | Zero Additional Dependencies | Production Ready

⚡ Key Features

Technical Excellence

Performance - <50ms operations, rigorously benchmarked
Reliability - Extensively tested including edge cases
Type Safety - 100% TypeScript with FULL strict mode 🏆
Security - Minimal dependencies (only MCP SDK)
Production Ready - Zero-error tolerance

🏆 NEW in v2.4.0: TypeScript Championship

From "Speed Demon" to "Championship Legend" - Proved you CAN have both speed AND safety!

✅ Full strict: true enabled with ALL safety flags
✅ Zero TypeScript errors across 1,400+ lines
✅ 35/35 tests passing - Type safety doesn't break functionality
✅ Performance maintained - Still sub-millisecond operations
✅ Build time unchanged - Sub-2 second builds

The Impossible Achieved: Speed + Safety + Quality = Championship 🏎️🛡️

🚀 Quick Install

⚡️💥 GET BOTH! Double Down! (100% FREE)

# Install BOTH for maximum power - completely FREE!
npm install -g faf-cli           # 🩵 Cyan CLI - Command Line Tool (v2.4.6 - 60% FASTER!)
npm install -g claude-faf-mcp    # 🧡 Orange Smiley MCP - Claude Desktop integration

# 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.

🎉 Friday Features - Chrome Extension Support!

Chrome Extension Auto-Detection | Projects detected as Chrome Extensions automatically get 90%+ scores Universal Fuzzy Matching | Type "raect" or "chr ext" - we know what you mean! Intel-Friday™ | Smart detection that fills 7 critical integration points for Chrome Extensions

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 auto - Auto-detect and generate
faf score - Calculate AI readiness score
faf status - Get project status

Enhancement Tools

faf enhance - Optimized scoring system
faf sync - Sync .faf with CLAUDE.md
faf bi-sync - Bidirectional sync

Management Tools

faf trust - Validate context integrity
faf clear - Clear caches

📖 Usage

Drop a file - Drop package.json, README, or any project file into Claude
Instant context - Claude immediately understands your project
Use tools - Just type "faf" and Enter
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.4.0 (TypeScript Championship Release)
├─ 🏆 TypeScript: 100% Strict Mode
├─ 🚀 Performance: <1ms operations
├─ 📦 Dependencies: 1 (MCP SDK only)
├─ 🧪 Tests: 35/35 passing
├─ 🔨 Build: Zero errors, <2s
└─ 🏁 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

⚡️💥 The Complete FAF Ecosystem

🩵⚡️ Cyan CLI • 🧡⚡️ Orange Smiley MCP • 💚⚡️ WEB • 🧰⚡️ DevOps • 🖥️⚡️ Chrome

🏎️⚡️ FAST AF - Project DNA for ANY AI ✨

Made with 🧡 by wolfejam | ZERO DEPENDENCIES, ZERO FAFF™ | Growing Community 🎉

100% FREE Forever • No Strings Attached • Just Build with Claude