.FAF Context — Claude Code MCP server: setup
This MCP server keeps project context in project.faf and syncs it to files used by different AI tools. Use it when one shared context is needed.
claude mcp add faf-mcp -- npx -y faf-mcpWhat .FAF Context does
.FAF Context treats project.faf as the project context source. It can create and update AGENTS.md, .cursorrules, GEMINI.md, and CLAUDE.md, so several AI tools receive the same project rules. The server runs locally over stdio.
Its tool set includes faf_auto, faf_go, faf_dna, faf_doctor, and faf_claude; these work with the context and score files through the faf-cli engine. Node 22 or newer is required, so an older Node runtime prevents the server from starting. In Claude Code, add it with claude mcp add faf-mcp -- npx -y faf-mcp.
What it helps with
- share project context across AI tools
- generate
CLAUDE.mdfromproject.faf - sync
AGENTS.mdand.cursorrules - inspect context file scores
- run a local MCP server over stdio
Example prompts for the agent
- Use FAF and read the project rules from
project.faf. - Sync the project context into
CLAUDE.mdandAGENTS.md. - Check the context status and score the project files with FAF.
How to install .FAF Context
Platform CLI
claude mcp add faf-mcp -- npx -y faf-mcpPlatform CLI
codex mcp add faf-context -- npx -y faf-mcpConfig file
{
"mcpServers": {
"faf-context": {
"command": "npx",
"args": [
"-y",
"faf-mcp"
]
}
}
}Config file
{
"servers": {
"faf-context": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"faf-mcp"
]
}
}
}Platform CLI
gemini mcp add faf-context npx -y faf-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about .FAF Context
How do I install .FAF Context in Claude Code?
Run claude mcp add faf-mcp -- npx -y faf-mcp.
What does .FAF Context do?
It takes context from project.faf and syncs it to CLAUDE.md, AGENTS.md, .cursorrules, and GEMINI.md. The server runs locally over stdio.
Which Node version does .FAF Context require?
Node 22 or newer is required. The server will not start on an older Node version.
