faf-mcp

Wolfe-Jam/faf-mcp

3.2

If you are the rightful owner of 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.

FAF-MCP is a universal Model Context Protocol server designed for the .FAF (Foundational AI-context Format), providing persistent project context across various platforms.

faf-mcp | use>faf

IANA-Registered Format for AI Context · application/vnd.faf+yaml

Universal MCP server for .FAF (Foundational AI-context Format) with 17 native tools + CLI fallback - Persistent project context for Cursor, Windsurf, Cline, VS Code, and all MCP-compatible platforms (including Claude Desktop)

Universal version of claude-faf-mcp — Anthropic-approved MCP server, now compatible with all platforms. Built on the IANA-registered .FAF format (application/vnd.faf+yaml).

NPM Downloads Discord Chrome Web Store Website License: MIT

⚡ Quick Start

1. Install:

npm install -g faf-mcp

2. Copy and paste this to your AI:

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

Platform-Specific Setup

Cursor IDE: Add to ~/.cursor/mcp.json (setup guide)

Windsurf Editor: Add to ~/.codeium/windsurf/mcp_config.json (Cascade docs)

Cline: Add to Cline's MCP settings

VS Code: Install MCP extension, then add server config

Claude Desktop: Use the dedicated claude-faf-mcp package for optimized Claude integration

🏁 AI-Readiness Scorecard

"README for the AI era" — Google Gemini

project.faf is to AI context what package.json is to dependencies

Lives at the project root, between package.json and README.md

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 — PODIUM EDITION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 CORE INTELLIGENCE                    🎯 CONTEXT DELIVERY
├─ Project DNA            [██████] 100%  ├─ MCP Protocol      [██████] 100%
├─ Architecture Map       [██████] 100%  ├─ 17 Native Tools   [██████] 100%
├─ Domain Model          [██████] 100%  ├─ IANA Format       [██████] 100%
└─ Version Tracking      [██████] 100%  └─ Universal Context [██████] 100%

🚀 PERFORMANCE                          ⚡ STANDALONE OPERATION
├─ 16.2x CLI Speedup     [██████] 100%  ├─ Zero Dependencies [██████] 100%
├─ 19ms Avg Execution    [██████] 100%  ├─ Bundled Engine    [██████] 100%
├─ 17/17 Tools Active    [██████] 100%  ├─ Direct Function   [██████] 100%
└─ Zero Memory Leaks     [██████] 100%  └─ 14 Bundled Cmds   [██████] 100%

🏆 project.faf score: podium
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯 Want a Platform-Specific Package?

We're launching faf-mcp as the universal package. If you'd prefer a dedicated package for your platform (like cursor-faf-mcp or windsurf-faf-mcp with tailored setup instructions), request it here.

We'll publish platform-specific packages based on demand.

💬 use>faf | Prompt Pattern

Start every prompt with "Use FAF" to invoke MCP tools directly:

All Platforms

Use FAF to initialize my project
Use FAF to sync my project.faf to all platforms
Use FAF to score my AI-readiness
Use FAF to enhance my project context
Use FAF to create platform sync files

Why "Use FAF" Works Everywhere

Claude Desktop:

  • ✅ Calls MCP tool instead of searching web
  • ✅ No void container issues
  • ✅ Direct tool invocation

Claude.ai (Web):

  • ✅ Stops web search addiction immediately
  • ✅ Forces MCP tool usage
  • ✅ No more guessing

Cursor / Windsurf / Cline:

  • ✅ MCP standard compliance
  • ✅ Tool invocation (not manual file creation)
  • ✅ Consistent behavior

The Pattern

Without "Use FAF":

  • ❌ AI searches the web
  • ❌ AI creates files manually
  • ❌ Void containers
  • ❌ Inconsistent results

With "Use FAF":

  • ✅ MCP tool called correctly
  • ✅ Championship output
  • ✅ Every time

🎯 What is FAF?

The .FAF Position in the MCP Ecosystem:

  Platform      Context          Protocol
  ────────      ───────          ────────
  Any IDE   →   IANA Format →    Open Protocol
  Cursor    →   .faf        →    MCP
  Windsurf  →   .faf        →    MCP
  Cline     →   .faf        →    MCP
  VS Code   →   .faf        →    MCP
  Claude    →   .faf        →    MCP
  Gemini    →   .faf        →    MCP

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

🛠️ Core Features

17 Native MCP Tools

  • faf_init - Initialize project.faf with auto-detection
  • faf_score - AI-readiness scoring engine
  • faf_enhance - Intelligent enhancement with auto-detection
  • faf_read - Parse and validate FAF files
  • faf_write - Create/update FAF with validation
  • faf_sync - Synchronize context across platforms
  • faf_bi_sync - Bi-directional CLAUDE.md sync

CLI Fallback (40+ commands)

  • faf readme - Smart 6 Ws extraction from README.md
  • faf human-add - Non-interactive human context entry
  • faf git - GitHub repo extraction (Git CLI, no rate limits)
  • Plus all other faf-cli commands

IANA-Registered Standard

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

Championship 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 with F1-grade engineering

📚 Documentation

🏆 Why FAF?

Championship Credentials

🏅 Creators of the Format - We designed .FAF (IANA-registered application/vnd.faf+yaml) 🏅 First & Only - Persistent Project Context MCP Server approved by Anthropic 🏅 Creators of Context-Mirroring - faf_bi_sync creates native files for all platforms 🏅 Google Chrome-Approved - Published Chrome Extension 🏅 15K+ npm Downloads - Proven adoption across the FAF ecosystem

"README for the AI era" — Google Gemini

The FAF Advantage

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, Cursor, Windsurf, any MCP platform

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

FREE FOREVER - MIT License, open source, no subscription

All Boats Rise Together - Improving projects, AI performance, code quality, speed to market for everyone

Championship Engineering - F1-inspired performance with strict TypeScript, zero runtime errors

📦 Ecosystem

📄 License

MIT License - Free and open source

Built with F1-inspired engineering principles 🏎️⚡

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