# Wolfe-Jam/claude-faf-mcp [Health: Active]

**Category:** 🧠 Knowledge & Memory  
**Repository:** https://github.com/Wolfe-Jam/claude-faf-mcp  
**GitHub Stars:** 23  
**npm Downloads (last month):** 2823  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/wolfe-jam-claude-faf-mcp

## Description
First & only persistent project context MCP. Provides .faf (Foundational AI-context Format) Project DNA with 33+ tools, Podium scoring (0-100%), and format-driven architecture. Official Anthropic Registry. 10k+ npm downloads.

## Tools
Capabilities this server exposes over MCP:

- **faf_init** — Initialize project DNA
- **faf_auto** — Auto-detect stack and populate context
- **faf_quick** — Lightning-fast creation (3ms)
- **faf_readme** — Extract context from README (+25-35% boost)
- **faf_formats** — Discover all formats in your project
- **faf_git** — Extract context from any GitHub repo URL
- **faf_human_add** — Add human context (the 6Ws)
- **faf_score** — AI-readiness score (0-100%) with breakdown
- **faf_bench** — Benchmark AI grounding — cold vs .faf, with a `✪` receipt
- **faf_check** — Validate .faf structure
- **faf_doctor** — Diagnose and fix common issues
- **faf_go** — Guided interview to Gold Code
- **faf_sync** — Sync .faf → CLAUDE.md — `agents`/`cursor`/`gemini`/`copilot`/`all` also emit AGENTS.md / .cursorrules / GEMINI.md / copilot-instructions.md
- **faf_tri_sync** — Tri-sync .faf ↔ CLAUDE.md ↔ MEMORY.md — Pro feature, free for developers 🐘
- **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_read** — Read any file
- **faf_write** — Write any file
- **faf_status** — Project status overview
- **faf_debug** — Environment inspection
- **faf_about** — What is .faf?

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `bunx` (confidence: high):

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

## Documentation

## What Wolfe-Jam/claude-faf-mcp MCP server does

Wolfe-Jam/claude-faf-mcp MCP server manages persistent project context in the `.faf` format, described in the repository as Foundational AI-context Format. The context is intended to capture both repository information and human-supplied intent, including the six project questions commonly represented as who, what, why, where, when, and how.

The server exposes a core set of MCP tools for creating, reading, checking, scoring, and synchronizing this context. It can initialize project DNA, inspect a project’s technology stack, derive information from a README, or load context from a GitHub repository URL. Human context can be added separately rather than inferred from source files.

Its scoring tools report an AI-readiness result from 0 to 100% with a breakdown. `faf_bench` compares agent grounding with and without the `.faf` file and emits a receipt describing the result. The available tools also include project status, environment inspection, file reads and writes, and an explanation of the `.faf` format.

## How it works

The repository treats `.faf` as the primary context source. `faf_init`, `faf_auto`, and `faf_quick` provide different entry points for creating project context, while `faf_go` guides the user through an interview intended to improve the result. `faf_readme` and `faf_git` add evidence from existing project documentation or a remote GitHub repository.

After context is created, `faf_check` validates its structure and `faf_doctor` diagnoses and fixes common problems. `faf_score` measures the resulting context, and `faf_status` provides a project-level view. The README also describes a `/faf` prompt for Claude Desktop that checks, scores, and synchronizes a project.

Wolfe-Jam/claude-faf-mcp MCP server can synchronize `.faf` into `CLAUDE.md`. Its synchronization options also cover AGENTS.md, `.cursorrules`, GEMINI.md, and `.github/copilot-instructions.md`. A tri-sync operation connects `.faf`, `CLAUDE.md`, and `MEMORY.md`.

## Setup and configuration

The project is published as the npm package `claude-faf-mcp` and is licensed under MIT. The repository describes the server as a TypeScript MCP server and includes an npm package badge. A package-runner configuration can start it with:

```bash
npx -y claude-faf-mcp
```

The README distinguishes between a core tool set and an expanded set: it states that the server has 12 core tools and 34 tools when `FAF_TOOLS=all` is used. The supplied material does not document other required environment variables, credentials, API keys, or hosted service endpoints.

## Tools and capabilities

The listed capabilities include:

- Initialize, auto-populate, or quickly create project DNA.
- Extract context from README files and GitHub repository URLs.
- Add human context using the six project questions.
- Score AI readiness and benchmark grounding with a receipt.
- Validate `.faf` structure and diagnose common issues.
- Read and write files, inspect the environment, and show project status.
- Import or export AGENTS.md, `.cursorrules`, GEMINI.md, and Conductor content.
- Synchronize project context into files used by several coding assistants.

Wolfe-Jam/claude-faf-mcp MCP server is most relevant when repository code alone does not express project intent, or when several agent clients need a shared, generated context surface.

## Limitations and notes

The provided material does not specify operating-system requirements, supported Node.js versions, or a complete installation walkthrough. Although the tools include GitHub URL extraction, no GitHub credential requirement is stated. The tri-sync capability is identified as a Pro feature in the tool list, while also being described there as free for developers; the supplied information does not define any separate paid plan or feature limits. The README refers to version-specific composition with `faf-cli`, but the exact dependency installation and version-management procedure is not included here.

_Full upstream README: https://allmcps.com/mcp/wolfe-jam-claude-faf-mcp/readme_