rust-faf-mcp 0.2.0

Rust MCP server for FAF (Foundational AI-context Format) — IANA-registered application/vnd.faf+yaml
rust-faf-mcp-0.2.0 is not a library.

rust-faf-mcp

Rust MCP server for FAF (Foundational AI-context Format) — IANA-registered application/vnd.faf+yaml.

5 tools. 49 tests. Powered by faf-rust-sdk.

What is FAF?

FAF is a structured YAML format that gives any AI instant project context. One project.faf file replaces the "let me explain my project" tax at the start of every conversation. IANA-registered, open standard, MIT licensed.

Install

cargo install rust-faf-mcp

Usage

Stdio-based MCP server. Add to your MCP client config:

{
  "mcpServers": {
    "faf": {
      "command": "rust-faf-mcp"
    }
  }
}

Tools

Tool Description
faf_init Create or enhance a project.faf. Detects Cargo.toml, package.json, pyproject.toml, go.mod. Low score? Run again — it enhances each time.
faf_git Generate project.faf from a GitHub URL. Fetches repo metadata and creates AI context instantly.
faf_read Read and display project.faf with parsed structure and score.
faf_score Score AI-readiness (0-100%) with tier badge, breakdown, and suggestions.
faf_sync Bi-directional sync between project.faf and CLAUDE.md. Preserves custom content.

The Loop

$ faf_init → Created project.faf — 40% Yellow
$ faf_init → Enhanced — 65% Green
$ faf_init → Enhanced — 85% Silver
$ faf_init → Already complete — 90% Silver

Low score? Run faf_init again. It detects what's missing and fills it in.

Language Detection

Manifest Language
Cargo.toml Rust
package.json + tsconfig.json TypeScript
package.json JavaScript / Node.js
pyproject.toml Python
go.mod Go

Testing

49 tests across 3 WJTTC tiers:

Tier Focus Tests
T1 BRAKES Security (path traversal, injection, malformed input) 12
T2 ENGINE Core (MCP protocol, all 5 tools, language detection) 27
T3 AERO Edge cases (unicode, boundaries, URL parsing) 10 
cargo test

Ecosystem

Package Platform Registry
claude-faf-mcp Anthropic npm
grok-faf-mcp xAI npm
gemini-faf-mcp Google PyPI
faf-mcp Universal npm
rust-faf-mcp Rust crates.io

Links

License

MIT