Official MCP server for .FAF (Foundational AI-context Format) with 52 tools - Persistent project context that integrates seamlessly with Claude Desktop workflows

NPM Downloads Discord Chrome Web Store Website License: MIT

❌ Without FAF

You: "Update the auth module" AI: "What framework? What patterns? Where are the files?" You: "It's Express with JWT, files in /src/auth..." AI: "What's the error handling approach?" You: "We use custom AppError class..." AI: "Database schema?" You: [15 minutes later, still explaining]

Every session. Every project. Every AI tool. Starting over.

✅ With FAF

You: "Update the auth module" AI: [Reads project.faf] "Got it. Express + JWT, AppError pattern, files in /src/auth, PostgreSQL with Prisma. Making the change."

One file. Persistent context. Every AI knows your project.

🏁 AI-Readiness Scorecard

The closer you get to 100% the better AI can assist you.

At 55% you are building your project with half a blueprint and basically flipping a coin with AI. .FAF defines, and AI becomes optimized for Context with the project.faf file.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🏆 FAF AI-READINESS SCORE: 100/100 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📊 CORE INTELLIGENCE 🎯 CONTEXT DELIVERY ├─ Project DNA [██████] 100% ├─ MCP Protocol [██████] 100% ├─ Architecture Map [██████] 100% ├─ 52 Native Tools [██████] 100% ├─ Domain Model [██████] 100% ├─ IANA Format [██████] 100% └─ Version Tracking [██████] 100% └─ Universal Context [██████] 100% 🚀 PERFORMANCE ⚡ STANDALONE OPERATION ├─ 16.2x Speedup [██████] 100% ├─ Zero Dependencies [██████] 100% ├─ 19ms Avg Execution [██████] 100% ├─ Bundled Engine [██████] 100% ├─ 52/52 Tools Active [██████] 100% ├─ Direct Function [██████] 100% └─ Zero Memory Leaks [██████] 100% └─ 14 Bundled Cmds [██████] 100% 🏆 Status: Trophy - Perfect AI context ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Tier System

Tier	Score	Emoji	Meaning
Trophy	100%	🏆	Perfect AI context
Gold	99%+	🥇	Exceptional
Silver	95%+	🥈	Top tier - Excellent
Bronze	85%+	🥉	Strong - Production ready
Green	70%+	🟢	Good - Solid foundation
Yellow	55%+	🟡	Caution - Needs improvement
Red	<55%	🔴	Critical - AI working blind
White	0%	🤍	Empty - No context

⚡ Quick Start

Copy and paste this to Claude/your AI:

Install the FAF MCP server: npm install -g claude-faf-mcp, then add this to my claude_desktop_config.json: {"mcpServers": {"faf": {"command": "npx", "args": ["-y", "claude-faf-mcp"]}}} and restart Claude Desktop.

One-Click Alternative: Desktop Extension (.mcpb)

🎯 What is FAF?

The .FAF Position in the MCP Ecosystem:

Model Context Protocol ───── ─────── ──────── LLM → IANA Format → Open Protocol Claude → .faf → MCP Gemini → .faf → MCP Codex → .faf → MCP

.FAF is the foundational, universal base layer for any Model using the MCP Protocol. It provides the standardized Context that makes the Model Context Protocol work for everyone.

🛠️ Core Features

52 MCP Tools (100% Standalone)

faf_quick - Lightning-fast project.faf creation (3ms avg)
faf_readme - Smart 6 Ws extraction from README.md (+25-35% score boost)
faf_human_add - Non-interactive human context entry (Claude Code compatible)
faf_enhance - Intelligent enhancement with auto-detection
faf_read - Parse and validate FAF files
faf_write - Create/update FAF with validation
faf_score - AI-readiness scoring engine (with subsite auto-detection)
faf_compress - Intelligent size optimization
14 bundled commands - Zero CLI dependencies, 16.2x faster

IANA-Registered Standard

Official MIME type: application/vnd.faf+yaml
W3C-compliant structured format
Universal AI context protocol
Cross-platform compatibility

Performance

16.2x faster than CLI versions (direct function calls vs process spawning)
19ms average execution across all bundled commands
Fastest: 1ms (formats command)
Zero memory leaks

📚 Documentation

CHANGELOG - Version history and release notes
Full Documentation - Complete guide
FAQ - Common questions
Getting Started - Installation & setup
MCP Tools Reference - All 52 tools
Website - faf.one
Discord Community - Join the discussion

🏆 Why FAF?

"README for the AI era" — Gemini CLI

Persistent Context - Your project's DNA lives in project.faf, readable by any AI or human

Universal Format - IANA-registered standard works across Claude, Gemini, Codex, any LLM

Zero Setup Tax - One file (project.faf) eliminates AI context setup across your entire team

Quality Engineering - Strict TypeScript, zero runtime errors

📦 Ecosystem

FAF Format Spec - Official IANA specification
FAF CLI - Command-line tooling
faf-wasm - WASM SDK for scoring (<5ms)
Chrome Extension - Browser integration
faf.one - Official website and documentation

📄 License

MIT License - Free and open source

Built for speed and reliability ⚡

"It's so logical if it didn't exist, AI would have built it itself" — Claude

claude-faf-mcp