.FAF Context
Attach .faf persistent project context to Cursor, Windsurf, Cline, or VS Code agents via the dedicated IDE edition MCP server.
Overview
faf-mcp is a Build-phase MCP server that supplies IANA .faf persistent project context to Cursor, Windsurf, Cline, and VS Code over stdio.
What is this MCP server?
- Dedicated IDE Edition titled .FAF Context for Cursor, Windsurf, Cline, and VS Code
- npm package faf-mcp v2.1.2 with stdio transport and runtimeHint npx
- IANA-registered .faf format shared with the broader faf.one ecosystem
- Repository Wolfe-Jam/faf-mcp; website faf.one
- stdio-only IDE package—differs from Claude SSE or Grok HTTP remotes
- Package faf-mcp version 2.1.2 on npm with stdio transport
- runtimeHint npx; title .FAF Context in server manifest
- IANA-registered .faf format; website faf.one
Community signal: 3 GitHub stars.
What problem does it solve?
Your IDE agent loses thread on project rules every time you open a new chat or switch tools, slowing solo shipping.
Who is it for?
Solo builders whose primary loop is Cursor, Windsurf, Cline, or VS Code with MCP enabled.
Skip if: Claude-only remote SSE setups or Gemini Python FastMCP stacks without an IDE stdio client.
What do I get? / Deliverables
Register faf-mcp with npx stdio so your editor agent reads and updates one .faf file that travels with the repo.
- IDE MCP server wired for .faf read/write
- Portable project context shared across editor agent sessions
- Documented npx stdio launch pattern for faf-mcp
Recommended MCP Servers
Journey fit
How it compares
IDE npx stdio edition, not the Claude-specific claude-faf-mcp SSE bundle.
Common Questions / FAQ
Who is faf-mcp for?
It is for developers using Cursor, Windsurf, Cline, or VS Code who want MCP-driven .faf project context in the editor.
When should I use faf-mcp?
Use it when you start agent-assisted coding on a repo and need conventions, structure, and tasks to persist across IDE sessions.
How do I add faf-mcp to my agent?
Add an MCP server entry that runs npx faf-mcp (stdio) in your IDE’s MCP configuration, matching package version 2.1.2.