claude-faf-mcp

claude-faf-mcp is the FAF MCP server for Claude-compatible clients, providing 33 tools to create, validate, score, and synchronize .faf Project DNA context files.

What this server does

FAF (Foundational AI-Context Format) is a portable YAML context format for preserving project intent across sessions, assistants, and IDE agents. claude-faf-mcp exposes FAF workflows through MCP tools so agents can operate on project context in a structured, repeatable way.

Key capabilities

• Generate and manage .faf project context files
• Validate context quality and completeness
• Score context to identify confidence gaps and improvement opportunities
• Keep context synchronized as project intent evolves
• Return structured outputs suitable for multi-step agent workflows

Core tools

• faf_init — Initialize project DNA
• faf_auto — Auto-detect stack and populate context
• faf_git — Extract context from any GitHub repo URL
• faf_score — AI-readiness score (0-100%) with breakdown
• faf_sync — Sync .faf → CLAUDE.md
• faf_go — Guided interview to Gold Code
• faf_agents — Import/export AGENTS.md (OpenAI Codex)
• faf_cursor — Import/export .cursorrules (Cursor IDE)
• faf_gemini — Import/export GEMINI.md (Google Gemini)
• faf_conductor — Import/export Conductor directory
• faf_formats — Discover all formats in your project

Why teams use it

• Reduces context drift between AI sessions
• Moves repetitive context operations from prompts into deterministic tools
• Gives Claude/IDE agent workflows a shared, portable context layer

Quick start

Install

npm install -g claude-faf-mcp

Install options (npm vs Homebrew)

• claude-faf-mcp server: install via npm
• faf-cli utility: available via npm and Homebrew (see FAF CLI docs/tap)

MCP config example

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

Example prompts

• "Analyze this repo and generate a starter .faf context file."
• "Validate my .faf file and list missing or weak sections."
• "Score this .faf and recommend the top 5 improvements."
• "Sync project context so .faf reflects current code and intent."

Useful one-liners

npx faf-cli@latest git https://github.com/facebook/react

or

npx faf-cli@latest git https://github.com/your-repo

Compatibility

• Claude Desktop and other MCP-compatible clients
• Common IDE-agent workflows (including VS Code/Cursor setups)

Safety / scope

• Designed for project context operations
• Effective permissions and access scope are controlled by your MCP client configuration
• Review write-capable actions before applying changes to local files

Links

• GitHub: https://github.com/Wolfe-Jam/claude-faf-mcp
• npm: https://www.npmjs.com/package/claude-faf-mcp
• FAF overview: https://faf.one
• MIME type reference: application/vnd.faf+yaml

Short version (optional)

claude-faf-mcp is the FAF MCP server for Claude-compatible clients, with 33 tools for creating, validating, scoring, and syncing .faf Project DNA files.

Install: npm install -g claude-faf-mcp

It helps reduce AI context drift by making project context operations structured and repeatable across sessions and IDE agents.

GitHub: https://github.com/Wolfe-Jam/claude-faf-mcp npm: https://www.npmjs.com/package/claude-faf-mcp