claude-faf-mcp v2.6.0 🏆

---

🏆 Championship Scoring System

Track your project's AI-readiness with F1-inspired tiers:

🏆 Trophy (100%)    - Championship - Perfect AI|HUMAN balance
🥇 Gold (99%)       - Gold standard
🥈 Silver (95-98%)  - Excellence
🥉 Bronze (85-94%)  - Production ready
🟢 Green (70-84%)   - Good foundation
🟡 Yellow (55-69%)  - Getting there
🔴 Red (0-54%)      - Needs attention

Live output in Claude Desktop:

🥉 Score: 88/100
█████████████████████░░░ 88%
Status: Bronze - Production Ready

Next milestone: 95% 🥈 Silver (7 points to go!)

---

🚀 Quick Start

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

# Add to Claude Desktop config
# macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-faf-mcp": {
      "command": "claude-faf-mcp"
    }
  }
}

Restart Claude Desktop → Ready! 🏁

---

🏆 Officially in Anthropic's MCP Registry

claude-faf-mcp is now officially part of the Anthropic MCP Ecosystem.

✅ PR #2759 merged Oct 17, 2025 - First .faf format server validated by Anthropic

Registry listing: "MCP server for .faf format. Context scoring engine with project context management."

This is just the beginning. 🧡⚡🏎️

---

🎯 What is claude-faf-mcp?

MCP server that brings .faf format to Claude Desktop for instant project understanding.

.faf = Project DNA ✨ for AI-Context, On-Demand Universal, shareable context for Claude, Codex, Gemini, or any AI - regardless of stack, size, or setup.

Key Features

• ✅ Zero Config - Works out of the box
• ✅ 33+ Tools - Complete project management
• ✅ <11ms Speed - Championship performance
• ✅ Bi-Sync - .faf ↔ CLAUDE.md synchronization
• ✅ Type Safe - 100% TypeScript strict mode
• ✅ Production Ready - 35/35 tests passing

---

🛠️ Available Tools

Core Tools

• faf_init - Initialize project context
• faf_auto - Auto-detect and populate
• faf_score - Calculate AI readiness
• faf_status - Project health check

Enhancement Tools

• faf_enhance - Optimize scoring
• faf_sync - Sync files
• faf_bi_sync - Bidirectional sync

File Operations

• faf_read - Read files
• faf_write - Write files
• faf_list - List directories
• faf_search - Search content

See all 33+ tools →

---

💡 Usage Example

1. Drop any project file into Claude Desktop
2. Type: "Run faf_auto to analyze this project"
3. Get instant context - Claude understands your codebase
4. Use tools - Access 33+ commands naturally in conversation

The .faf file persists across conversations - no need to re-explain your project!

---

📊 Technical Specs

Version:       2.6.0
Performance:   <11ms operations
TypeScript:    100% strict mode
Dependencies:  1 (MCP SDK only)
Testing:       730 C.O.R.E empirical tests (part of 12,500+ FAF ecosystem validation)
Build:         Zero errors
Coverage:      4,400+ lines

---

✨ What's New in v2.6.0

🏆 Post-Evaluation Release (94.4/100 Gold Standard)

• Type-safe tool handlers with proper TypeScript definitions
• Community contribution framework (templates, guidelines, funding)
• Repository cleanup: Removed 17K+ lines of legacy docs
• Improved TypeScript strict mode compliance across all handlers

v2.5.2 - Visual Championship Experience

• Orange Smiley branding - Complete visual identity on NPM
• Score card screenshot - See the actual terminal output
• Championship polish - Professional presentation

v2.5.1 - Documentation Polish

• Championship README - Trophy section leads for immediate impact
• Optimized description - Cleaner NPM presence
• Professional structure - Scannable, modern layout

v2.5.0 - Championship Edition

• 7-tier medal system for AI-readiness scoring
• Visual progress bars in terminal output
• Milestone tracking with next-level guidance
• Enhanced scoring for better project analysis

---

🏗️ Development

# Clone
git clone https://github.com/Wolfe-Jam/claude-faf-mcp.git
cd claude-faf-mcp

# Install & Build
npm install
npm run build

# Test
npm test

# Link locally
npm link

---

📋 Requirements

• Node.js 18+
• Claude Desktop (latest version)
• OS: macOS, Linux, or Windows

---

🔗 The FAF Ecosystem

• 🩵 faf-cli - Command line tool (v3.0.2 - Championship Edition 🏆 with Turbo Cat 😽)
• 🧡 claude-faf-mcp - This MCP server
• 💚 faf.one - Documentation & guides
• 🖥️ Chrome Extension - Browser integration

---

👤 Author

James Wolfe (Wolfe-Jam) Creator, .faf Format ORCID: 0009-0007-0801-3841

---

📄 License

MIT License - See LICENSE file

Note: The .faf-Engine is proprietary and available under separate license.

---

🤝 Contributing

We welcome contributions! Join our community discussions or submit issues/PRs.

---