Log inSubmit server
Claude Faf MCP logo

Claude Faf MCP

by Wolfe-Jam

Creates and maintains .faf project context for AI agents, with scoring, validation, file sync, and project-context import tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Claude Faf MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "wolfe-jam-claude-faf-mcp": {
      "command": "bunx",
      "args": [
        "faf"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command didn't complete successfully in our automated test.

bunx faf

/bin/bash: line 1: bunx: command not found

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 29d ago.

Overview

Wolfe-Jam/claude-faf-mcp MCP server creates and maintains `.faf` project context files for AI-assisted development. It can detect a project stack, extract context from README files or GitHub repositories, collect human-provided project goals, and score AI readiness from 0 to 100%. Use it when an agent needs consistent project context across sessions or when that context must be synchronized into files used by Claude, Cursor, Gemini, Copilot, or OpenAI Codex. The server also provides validation, diagnostics, benchmarking, file access, and guided context creation tools.

Use cases

  • Create a shared project context file for coding agents
  • Score a repository’s AI readiness
  • Sync .faf context into assistant instruction files
  • Benchmark agent grounding with and without project context

Key features

  • Creates and updates .faf project DNA
  • Detects project stacks and extracts README or GitHub context
  • Scores AI readiness from 0 to 100%
  • Validates and diagnoses .faf files
  • Synchronizes context across assistant instruction formats
  • Imports and exports agent context files

Tools30

What Claude Faf MCP lets your agent do. Expand a tool for its parameters.

Self-reported~497 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

17/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · faf (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars23Stargazers on the source repository.
npm downloads2.3kPackage downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.
Install checkInconclusiveInstall command did not finish in our automated test.
Tools exposed30Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Claude Faf MCP works

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.

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:

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

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

Although the tools include GitHub URL extraction, no GitHub credential requirement is stated. The README refers to version-specific composition with faf-cli, but the exact dependency installation and version-management procedure is not included here.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Claude Faf MCP

Run the published npm package with `npx -y claude-faf-mcp`.

Yes.

It uses a `.faf` file containing project context, including repository information and human-supplied project intent.

Yes. Its synchronization tools can emit `.cursorrules` and `.github/copilot-instructions.md`, along with other supported instruction files.

Related MCP servers

All in Knowledge & Memory All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewClaude Faf MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/wolfe-jam-claude-faf-mcp?style=directory)](https://allmcps.com/mcp/wolfe-jam-claude-faf-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/wolfe-jam-claude-faf-mcp"><img src="https://allmcps.com/api/badge/wolfe-jam-claude-faf-mcp?style=directory" alt="Claude Faf MCP on AllMCPs" /></a>