# LobeHub MCP Marketplace Submission

## Plugin Information

**Plugin Name:** faf-mcp
**Display Name:** .faf - USE>FAF™
**Plugin Type:** MCP Server
**npm Package:** faf-mcp
**Version:** 1.0.6

## Metadata

**Author:** wolfejam
**Homepage:** https://faf.one
**Repository:** https://github.com/Wolfe-Jam/faf-mcp
**License:** MIT

## Description

### Short Description

**"README for the AI era"** — Google Gemini

**Creators of the .FAF format.** First & only Persistent Project Context MCP server approved by Anthropic. **Context-Mirroring pioneer** - faf_bi_sync creates platform-native files for all AI setups. 50 tools, IANA-registered, 12K+ downloads. Works across Claude Desktop, Cursor, Windsurf, VS Code, and all MCP platforms.

**project.faf is to AI context what package.json is to dependencies.**

Start every prompt with "Use FAF" for instant context intelligence.

### Long Description

**USE>FAF™ - The Universal Solution for AI Context**

> **"README for the AI era"** — Google Gemini

**Championship Credentials:**
- 🏅 Creators of the Format - We designed .FAF (IANA-registered `application/vnd.faf+yaml`)
- 🏅 First & Only - Persistent Project Context MCP Server approved by Anthropic
- 🏅 Creators of Context-Mirroring - faf_bi_sync creates native files for all platforms
- 🏅 Google Chrome-Approved - Published Chrome Extension
- 🏅 12K+ npm Downloads - Proven adoption across the ecosystem

faf-mcp is the universal MCP server providing 50 championship-grade tools for managing AI context across all platforms. Built on the IANA-registered .FAF format, it delivers persistent project intelligence that works everywhere.

**project.faf is to AI context what package.json is to dependencies.**

**The "Use FAF" Pattern:**

Start every prompt with "Use FAF" to invoke MCP tools correctly. This is the MCP standard that works across:
- Claude Desktop (no void containers, no web search)
- Claude.ai Web (stops web search addiction)
- Cursor IDE (tool invocation, not manual creation)
- Windsurf Editor (MCP compliance)
- Cline (consistent behavior)
- VS Code (universal compatibility)

**50 MCP Tools:**

- `faf_quick` - Lightning-fast project.faf creation (3ms avg)
- `faf_init` - Initialize FAF context with auto-detection
- `faf_enhance` - Intelligent enhancement with framework detection
- `faf_read` - Parse and validate FAF files
- `faf_write` - Create/update FAF with strict validation
- `faf_score` - AI-readiness scoring (0-100%)
- `faf_bi_sync` - Platform-aware sync to .cursorrules, .clinerules, .windsurfrules, CLAUDE.md
- `faf_validate` - Schema validation and error reporting
- 42 more specialized tools

**Championship Performance:**

- 16.2x faster than CLI alternatives
- 19ms average execution time
- Bundled engine (zero dependencies)
- Zero memory leaks
- F1-inspired engineering

**Platform-Aware Sync:**

Automatically creates platform-specific context files:
- `.cursorrules` for Cursor IDE
- `.clinerules` for Cline
- `.windsurfrules` for Windsurf
- `CLAUDE.md` for Claude Desktop

All synced from one universal `project.faf` source of truth.

**AI-Readiness Scoring:**

Objective 0-100% measurement of project context quality:
- 0-54%: INCOMPLETE (Pit Stop Required)
- 55-84%: GOOD (Racing Condition)
- 85-94%: BRONZE (Podium Contender)
- 95-99%: SILVER (Championship Form)
- 100%: GOLD (Pole Position)

**IANA-Registered Standard:**

Official MIME type: `application/vnd.faf+yaml`
- W3C-compliant structured format
- Universal AI context protocol
- Cross-platform compatibility
- Recognized standard for AI-augmented development

## Installation

```bash
npm install -g faf-mcp
```

## Configuration

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

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

### Cursor IDE

Add to `~/.cursor/mcp.json`:

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

### Windsurf Editor

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

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

## Usage Examples

```
Use FAF to initialize my project
Use FAF to sync my project.faf to all platforms
Use FAF to score my AI-readiness
Use FAF to enhance my project context
Use FAF to validate my project.faf
```

## Features

- 50 MCP Tools
- IANA-Registered Format (application/vnd.faf+yaml)
- Platform-Aware Sync
- AI-Readiness Scoring (0-100%)
- 16.2x Performance Boost
- Zero Dependencies (Bundled Engine)
- Universal Compatibility
- F1-Inspired Engineering

## Categories

- Developer Tools
- AI Assistants
- Project Management
- Code Quality
- Context Management

## Keywords

mcp, mcp-server, model-context-protocol, faf, ai-context, project-dna, claude, cursor, windsurf, gemini, vscode, anthropic, iana-format, universal-context, ai-readiness, developer-tools, typescript

## Support Links

- **Documentation:** https://wolfe-jam.github.io/claude-faf-mcp/
- **GitHub Issues:** https://github.com/Wolfe-Jam/faf-mcp/issues
- **Discord Community:** https://discord.com/invite/3pjzpKsP
- **FAQ:** https://github.com/Wolfe-Jam/claude-faf-mcp/blob/main/docs/FAQ.md

## Icon

Orange Smiley (256x256px PNG)
Path: `./assets/icons/faf-icon-256.png`

## Screenshots

1. AI-Readiness Scorecard (100% visualization)
2. project.faf file positioning (between package.json and README.md)
3. Platform sync demonstration (all 4 files created)
4. "Use FAF" prompt examples

## Additional Resources

- **Website:** https://faf.one
- **Chrome Extension:** https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm
- **FAF Specification:** https://github.com/Wolfe-Jam/faf
- **Changelog:** https://github.com/Wolfe-Jam/faf-mcp/blob/main/CHANGELOG.md

---

**USE>FAF™ - Universal AI context for all platforms** 🏎️⚡
