claude-faf-mcp

Overview

claude-faf-mcp is an MCP server that implements the FAF (Forever After Format) protocol to provide persistent project context for Claude. It enables developers to maintain accurate project understanding across sessions by using a standardized .faf format file. The server includes 33 tools covering project initialization, validation, scoring, synchronization, and file operations. It supports bi-directional sync with CLAUDE.md and optional tri-sync with MEMORY.md for enhanced context retention.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• faf_init

  Initialize project DNA

  Try:Initialize my project with FAFTry:Create a new .faf file for my project
• faf_auto

  Auto-detect stack and populate context

  Try:Auto-detect my project stackTry:Populate context automatically for my project
• faf_readme

  Extract context from README

  Try:Extract context from my READMETry:Analyze my README for project information
• faf_score

  AI-readiness score (0-100%) with breakdown

  Try:Score my project for AI readinessTry:Get a breakdown of my project's AI score
• faf_sync

  Sync .faf → CLAUDE.md

  Try:Sync my .faf file to CLAUDE.mdTry:Update CLAUDE.md with my project context
• faf_tri_sync

  Tri-sync .faf ↔ CLAUDE.md ↔ MEMORY.md

  Try:Enable tri-sync for my projectTry:Sync all three context files
• faf_agents

  Import/export AGENTS.md (OpenAI Codex)

  Try:Export my project context to AGENTS.mdTry:Import context from AGENTS.md
• faf_read

  Read any file

  Try:Read the main.js fileTry:Show me the contents of package.json
• faf_write

  Write any file

  Try:Write to a new fileTry:Update the README with new information
• faf_status

  Project status overview

  Try:Show my project statusTry:Get an overview of my project
• faf_doctor

  Diagnose and fix common issues

  Try:Diagnose my project issuesTry:Fix common FAF problems
• faf_git

  Extract context from any GitHub repo URL

  Try:Analyze this GitHub repositoryTry:Get context from https://github.com/user/repo

Comparable tools

Installation

claude mcp add --transport http claude-faf-mcp https://claude-faf-mcp.vercel.app/sse

npm install -g claude-faf-mcp

{
  "mcpServers": {
    "faf": { "command": "npx", "args": ["-y", "claude-faf-mcp"] }
  }
}

npx faf-cli auto

FAQ

What is the FAF format?

FAF (Forever After Format) is a standardized YAML format that captures project context through answers to key questions (Who, What, Why, Where, When, How). It's registered with IANA as application/vnd.faf+yaml.

How does the persistent context work?

The server maintains context through bi-sync (.faf ↔ CLAUDE.md) or tri-sync (.faf ↔ CLAUDE.md ↔ MEMORY.md) which ensures your AI remembers your project across sessions even when Claude Desktop is restarted.

Compare claude-faf-mcp with