Wolfe-Jam/claude-faf-mcp
If you are the rightful owner of claude-faf-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
The claude-faf-mcp is an official MCP server for the Foundational AI-context Format (FAF), providing a standardized context layer for AI models using the MCP protocol.
claude-faf-mcp
IANA-Registered Format for AI Context · application/vnd.faf+yaml
Official MCP server for .FAF (Foundational AI-context Format) with 52 tools - Persistent project context that integrates seamlessly with Claude Desktop workflows
❌ 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.
project.faf lives at the project root, between package.json and README.md
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏆 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
- - 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