# Rust FAF

> Rust FAF is a free MCP server for developer tools. Rust-native stdio MCP server that keeps project context in a single .faf file. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI
- **Website:** https://faf.one
- **Repository:** https://github.com/wolfe-jam/rust-faf-mcp
- **MCP Registry name:** one.faf/rust-faf-mcp
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/rust-faf
