claude-faf-mcp

claude-faf-mcp

MCP server for .faf format. Context scoring engine with project context management.

8
Stars
2
Forks
10
Releases

Overview

This is the official MCP server for FAF (Foundational AI-context Format), an IANA-registered AI-context format using the MIME type application/vnd.faf+yaml. It provides a persistent project context across Claude Desktop workflows by exposing around 50 native MCP tools for context creation, enhancement, parsing, updating, scoring, and compression. The server is designed to operate as a standalone solution with zero runtime dependencies and integrates with Claude Desktop via an MCP configuration (as shown in the Quick Start). A project.faf file lives at the project root and stores the DNA and domain context for the project. Core capabilities include faf_quick, faf_enhance, faf_read, faf_write, faf_score, and faf_compress, plus 14 bundled commands for broad functionality. The architecture emphasizes high performance, with claims of a 16.2x speedup over CLI equivalents, 19 ms average execution, and a fastest 1 ms for formatting, along with zero memory leaks and cross-platform compatibility. Documentation links accompany the release (CHANGELOG, full docs, FAQ, Getting Started, MCP Tools Reference) to support adoption and ongoing use.

Details

Owner
Wolfe-Jam
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

faf_quick

Lightning-fast project.faf creation (3ms avg)

faf_enhance

Intelligent enhancement with auto-detection

faf_read

Parse and validate FAF files

faf_write

Create/update FAF with validation

faf_score

AI-readiness scoring engine

faf_compress

Intelligent size optimization

50 Native Tools (Standalone)

50 native MCP tools for context management with zero CLI dependencies; designed for standalone operation

14 Bundled Commands and Performance

14 bundled commands with zero dependencies; 16.2x speedup vs CLI, 19 ms average execution, fastest 1 ms for formats

Audience

AI developersUse FAF MCP to manage persistent project contexts in Claude Desktop workflows.

Tags

FAFIANA FormatMCP.fafAI ContextClaude Desktoppersistent contextMIME type: application/vnd.faf+yamlcross-platform