Package Exports

claude-faf-mcp
claude-faf-mcp/dist/src/index.js

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.6.0 🏆

94.4/100 Gold Standard • Project DNA ✨ for ANY AI • 33+ Tools

Website • Docs • Community • Contributing

🏆 Championship Scoring System

FAF Championship Score Card

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! 🏁

🎯 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

Drop any project file into Claude Desktop
Type: "Run faf_auto to analyze this project"
Get instant context - Claude understands your codebase
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

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

Made with 🧡 by wolfejam.dev

100% FREE Forever • Zero Dependencies • Zero Faff™

⭐ Star on GitHub • 📦 View on NPM