Skip to content
MCP server

Rust FAF

Rust-native stdio MCP server that keeps project context in a single .faf file

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI
Runs
Locally
Version
0.9.0
Listing updated
3 days ago

About Rust FAF

Rust FAF is a free MCP server for developer tools. It runs locally on your machine and is started by your AI client.

rust-faf-mcp reads and writes project.faf, a YAML file describing what you are building, its stack, key files and commands, so each new AI session starts informed. It ships as a 4.3 MB stripped binary on stdio with no flags, config files or network listener.

The README describes faf_auto as the one-command path: it creates project.faf from detected facts if missing, then syncs CLAUDE.md, and lists what setup filled in. Human-only fields stay empty until you state them. Version 0.9.0 keeps a hand-written CLAUDE.md and refuses writes it cannot do safely.

Install with cargo, run through npx at a pinned version, or use Homebrew. It is built on rmcp and faf-rust-sdk.

Install

Run in a terminal

claude mcp add rust-faf-mcp -- npx -y rust-faf-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "rust-faf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "rust-faf-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "rust-faf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "rust-faf-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "rust-faf-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "rust-faf-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "rust-faf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "rust-faf-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "rust-faf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "rust-faf-mcp"
      ]
    }
  }
}

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

faf_auto
Set up if missing, sync CLAUDE.md and score
faf_init
First write of project.faf from the file tree
faf_sync
Sync CLAUDE.md from project.faf without overwriting hand-written content

What it does

One-file context
project.faf holds name, goal, language, stack, key files and commands.
faf_auto
Creates the file if missing, syncs CLAUDE.md and scores the result.
Safe sync
faf_sync preserves a hand-written CLAUDE.md and says what it declined to write.
Single binary
Stdio JSON-RPC only, no listener or config.
Three install routes
cargo, a pinned npx command, or Homebrew.

Good for

  • Stop re-explaining a project to each new AI session
  • Generate CLAUDE.md from a single source file
  • Bootstrap context for a Rust repository
  • Share the same context across several AI tools

Pricing

Free

Prices change. Check faf.one before you buy.

Rust FAF FAQ

How do I install it?

cargo install rust-faf-mcp, or run npx --yes rust-faf-mcp@0.9.0, or use the Homebrew tap.

Will it overwrite my CLAUDE.md?

No. faf_sync keeps a hand-written file and tells you when it refuses a write.

Does it open a network port?

No. It is stdio only.

Which clients work?

Claude Code, Cursor, Claude Desktop, Windsurf and any client that reads mcpServers.

Is Rust FAF free?

Yes. Rust FAF is free to use.

How do I add Rust FAF to Claude Code?

Run this command in your terminal: claude mcp add rust-faf-mcp -- npx -y rust-faf-mcp

What are the best alternatives to Rust FAF?

The closest alternatives to Rust FAF are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Rust FAF

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools