🏎️⚡️ Claude FAF MCP Server

F1-Inspired AI Context Management for Planet Claude

🏁 TESTING CENTER: /Users/wolfejam/faf-test-environment | View Dashboard 🏁

Claude FAF MCP Server | AI-Context on-demand management with bi-sync for Claude Users of all levels, with C.O.R.E performance faf-engine-Mk1

Transform your projects into AI-optimized collaboration spaces with C.O.R.E (Comprehensive, Optimized, Relentless, Empirical) performance powered by the faf-engine-Mk1 architecture.

🤖 What is Claude FAF MCP?

The Claude FAF MCP Server is a Model Context Protocol (MCP) server that provides Claude with intelligent project context and AI-powered enhancements. It bridges your project files with Claude's understanding through the FAF (Fast, Adaptive, and Friendly) context system.

Key Benefits

• 🧠 Intelligent Context: Automatically analyzes and optimizes your project for AI collaboration
• ⚡ Real-time Sync: Bi-directional synchronization between .faf context and claude.md
• 📈 AI Scoring: Get detailed metrics on your project's AI-readiness
• 🎯 Claude-Optimized: Specially tuned for optimal Claude performance
• 🌐 Universal: Works with Claude Desktop, Claude Web, and Claude API

💭 The World's First AI-Validated Developer Tool?

What the BIG-3 AI's themselves Say:

"its so logical [.faf] if it didn't exist, AI would have built it itself" - Claude Code

"package.json gives me a list of dependencies, .faf shows me what to do with them" - Claude Code

"package.json wasn't built for this, .faf was" - .faf Inventor

🏁 WOLFEJAM TESTING CENTER

📍 Location: /Users/wolfejam/faf-test-environment 📊 Dashboard: Open Testing Dashboard 📝 Full Guide: WOLFEJAM_TESTING_CENTER.md

Quick Test Commands

# Run Desktop MCP Test (ONE WAY TRACK - Permanent Record)
./DESKTOP_MCP_TEST_INTEGRATION.sh

# View Test Dashboard
open TESTING_CENTER_DASHBOARD.html

# Check Latest Results
ls -la /Users/wolfejam/faf-test-environment/DESKTOP_MCP_TESTS/

⚠️ ONE WAY TRACK: No deletions allowed - permanent test records only!

🚀 Quick Start

Prerequisites

• Node.js 18+
• FAF CLI installed globally

npm install -g faf-cli

Installation

npm install -g claude-faf-mcp

Configuration

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "claude-faf": {
      "command": "claude-faf-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

Or for development with a local FAF build:

{
  "mcpServers": {
    "claude-faf": {
      "command": "claude-faf-mcp", 
      "args": [
        "--transport", "stdio",
        "--faf-engine", "/path/to/your/faf/cli"
      ]
    }
  }
}

🛠️ Available Tools

The server provides 9 powerful tools for AI-enhanced development:

Core Analysis

• faf_status - Get comprehensive project status and AI readiness metrics
• faf_score - Calculate AI collaboration score with detailed breakdown
• faf_debug - Debug server environment and FAF CLI connectivity

Project Management

• faf_init - Initialize FAF context with intelligent stack detection
• faf_trust - Validate context integrity and trust metrics
• faf_clear - Clear caches and reset state

Context Optimization

• faf_enhance - Claude-optimized AI enhancement with multi-model support
• faf_sync - Synchronize .faf context with claude.md
• faf_bi_sync - Bi-directional sync with real-time watching

📖 Usage Examples

Initialize a New Project

Use the faf_init tool to set up FAF context for your project.

Check Project Health

Use faf_status to see your project's AI collaboration metrics:
- Context quality score
- AI readiness level  
- Performance metrics
- Claude compatibility rating

Optimize for Claude

Use faf_enhance with model="claude" and focus="claude-optimal" 
to get the best possible Claude collaboration experience.

Sync with Claude.md

Use faf_bi_sync to maintain automatic synchronization between 
your .faf context and claude.md file for seamless collaboration.

⚙️ Configuration Options

The server accepts several command-line options:

• --transport <stdio|http-sse> - Transport protocol (default: stdio)
• --port <number> - Port for HTTP-SSE transport (default: 3001)
• --faf-engine <path> - Path to FAF CLI (default: 'faf' global command)
• --debug - Enable debug logging

🏗️ Development Setup

Local Development

1. Clone and install dependencies:

git clone https://github.com/faf-dev/claude-faf-mcp.git
cd claude-faf-mcp
npm install

2. Build the project:

npm run build

3. Test locally:

npm run dev:stdio

4. Add to Claude config with local path:

{
  "mcpServers": {
    "claude-faf-dev": {
      "command": "npx",
      "args": ["ts-node", "src/cli.ts", "--transport", "stdio"],
      "cwd": "/path/to/claude-faf-mcp"
    }
  }
}

Testing

Run the test suite:

npm test

Test MCP protocol compliance:

npm run test:mcp

📋 Requirements

• Node.js: Version 18 or higher
• FAF CLI: Installed and accessible in PATH
• Claude Desktop: Latest version with MCP support
• Operating System: macOS, Linux, or Windows

📊 Real Performance Metrics

📈 Project Status: CHAMPION
├─ 💎 Context Quality: 100% 
├─ 🤖 AI Readiness: Universal
├─ ⚡ Performance: 38ms average
├─ 🧡 Community: Growing daily
└─ 📈 Enterprise Ready: Day One

🏁 The F1-Inspired Philosophy

We build software with F1-Inspired principles:

1. Precision Engineering - Every line purposeful
2. Performance Obsession - Milliseconds matter
3. Continuous Innovation - Always improving
4. Championship Standards - Only the best survives

Created by 🏎️⚡️wolfejam, F1-fanatic and inventor of .faf

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

📄 License

MIT License - see the LICENSE file for details.

🙋 Support

• GitHub Issues: Report bugs or request features
• Documentation: Full documentation
• Community: Join our Discord

🔗 Related Projects

• FAF CLI - The core FAF engine
• Claude Desktop - Anthropic's desktop application
• MCP SDK - Model Context Protocol SDK

Made with ❤️ for the Claude community

Transform your projects into AI-collaboration powerhouses with Claude FAF MCP Server!