← Back to directory
C

Claude FAF

Community
Persistent project context for Claude. IANA-registered .faf format.
GitHub source repository ↗
★ 22 Stars Category · Dev Tools Popular Source revision 62c408875b48
49FMRS · D

This server provides persistent context and memory capabilities with high integration, but users should be cautious about file operations; overall valuable.

Reliability
8/20
Security and permissions
8/20
Maintenance
11/20
Documentation
10/20
Setup experience
12/20
Read the FMRS scoring method →

Claude FAF is an MCP server that provides persistent project context and memory for Claude. It utilizes the IANA-registered .faf format (application/vnd.faf+yaml) to store a project's DNA, including stack, goals, and 6Ws. It offers tools to initialize, auto-detect, score, sync, and audit context, ensuring AI starts each session with a coherent understanding. It provides 13 core tools by default, extensible to 35. Interoperability with multiple AI environments is achieved through writing files like CLAUDE.md, AGENTS.md, etc.

Tools

faf_init
Initialize project DNA.
faf_auto
Auto-detect stack and populate context.
faf_go
Guided interview to Gold Code.
faf_bench
Benchmark AI grounding cold vs .faf, with a ✪ receipt.
faf_score
AI-readiness score (0-100%) with breakdown.
faf_doctor
Diagnose and fix common issues.
faf_sync
Sync .faf to CLAUDE.md or AGENTS.md etc.
faf_context
Get or display current context.
faf_trust
Verify score determinism.
faf_about
What is .faf?
faf_etch
Extract or embed context.
faf_recall
Recall memory.
faf_quick
faf_readme
faf_formats
faf_git
faf_human_add
faf_check
faf_tri_sync
faf_agents
faf_cursor
faf_gemini
faf_conductor
faf_read
faf_write
faf_status
faf_debug

Setup

Download the .mcpb file and double-click to install, or use npm install -g claude-faf-mcp, then configure claude_desktop_config.json with: {"mcpServers":{"faf":{"command":"bunx","args":["claude-faf-mcp"]}}} and restart Claude Desktop.

claude_desktop_config.json
{"mcpServers":{"faf":{"command":"bunx","args":["claude-faf-mcp"]}}}

Fit and risk

Best for

  • Developers using Claude Desktop
  • Teams needing persistent, versioned project context
  • Those requiring cross-session AI memory

Not for

  • Personal projects without AI context needs
  • Users not using AI tools that support .faf format
  • Users who may be overwhelmed by extended tools

Required permissions

  • Read and write project files
  • Runs locally, no network egress

Risks and side effects

  • File overwrites; review each sync
  • Some tools deprecated, but core stable

Troubleshooting

  1. Ensure npm package installed globally, check command in claude_desktop_config.json, ensure network access to npm or GitHub, or check Claude logs.

Use cases

Provide consistent project context in every Claude session.
Get new team members up to speed immediately after cloning the repo.
Persist project facts across sessions for AI memory.
Ensure AI follows project-specific conventions.

Supported clients

Claude DesktopFull support