Package Exports

faf-mcp
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 (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

faf-mcp

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

Universal MCP server for .FAF (Foundational AI-context Format) with 50 tools - Works with Claude Desktop, Cursor, Windsurf, and all MCP-compatible platforms

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

📊 CORE INTELLIGENCE                    🎯 CONTEXT DELIVERY
├─ Project DNA            [██████] 100%  ├─ MCP Protocol      [██████] 100%
├─ Architecture Map       [██████] 100%  ├─ 50 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%
├─ 50/50 Tools Active    [██████] 100%  ├─ Direct Function   [██████] 100%
└─ Zero Memory Leaks     [██████] 100%  └─ 14 Bundled Cmds   [██████] 100%

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

⚡ Quick Start

Copy and paste this to Claude/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

Claude Desktop: Add to claude_desktop_config.json (location guide)

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

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

VS Code: Install MCP extension, then add server config

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

🎯 What is FAF?

The .FAF Position in the MCP Ecosystem:

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

.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

50 MCP Tools (100% Standalone)

faf_quick - Lightning-fast project.faf creation (3ms avg)
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
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

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

Full Documentation - Complete guide
Getting Started - Installation & setup
MCP Tools Reference - All 50 tools
FAQ - Common questions
CHANGELOG - Version history

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

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

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

📦 Ecosystem

FAF Format Spec - Official IANA specification
FAF CLI - Command-line tooling
claude-faf-mcp - Claude Desktop-specific package
Chrome Extension - Browser integration
faf.one - Official website and documentation
Discord Community - Join the discussion

📄 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