convez.ai
MCP ServerProdutividadeIntermediário
Wolfe-Jam

faf-mcp

Wolfe-Jam/faf-mcp

Um arquivo `.faf`. Sincronizado em Cursor, Claude, Gemini, VS Code.

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que sincroniza um arquivo `.faf` único com múltiplas plataformas de IA (Cursor, Claude, Gemini, VS Code). Elimina a necessidade de manter vários arquivos de contexto em formatos diferentes, oferecendo 25 ferramentas para gerenciar instruções de projeto de forma centralizada e padronizada.

Instalação

$npx convez-ai Wolfe-Jam/faf-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
7
Forks
3
Acompanhando
0
Saúde
100%
Último commit
há 2 dias
Versão
v4.2.0
Issues abertas
3
Contribuidores
3

Casos de uso

  • Equipes que usam múltiplas ferramentas de IA e IDEs simultaneamente
  • Projetos que precisam manter contexto consistente entre plataformas
  • Automação de instruções de projeto sem duplicação de arquivos

Veredito

Ferramenta prática para times multi-plataforma que cansaram de sincronizar `.cursorrules`, `AGENTS.md` e equivalentes manualmente. O padrão IANA registrado e a maturidade do ecosistema FAF (62k+ downloads) indicam robustez, mas requer que todo o time adote o formato `.faf` para ser efetivo.

README

A tradução para o português deste README ainda está na fila.

FAF Trophy 100% IANA: vnd.faf+yaml DOI: Context paper

Home: wolfe-jam.github.io/faf-mcp · Hosted MCP endpoint: https://ide.faf.one/mcp/v1 (SSE: https://ide.faf.one/sse)

The MCP you didn't realise you needed, or wanted but didn't know who to ask, is here. Building on 62,000+ downloads across the FAF ecosystem, we bring you faf-mcp to cure your syncing pain and fuel your chosen AI with optimized context, on-demand.

CI npm version License: MIT project.faf


Define once. Sync everywhere.

You maintain .cursorrules. Your teammate uses AGENTS.md. Someone on the team just switched to Gemini. Every AI tool wants its own context file — and they all say the same thing in different formats.

faf-mcp is the dedicated MCP server for Cursor, Windsurf, Cline, VS Code, and every non-Claude platform. One .faf file in your repo, synced to every format your team needs.

                      project.faf
                           │
          ┌────────┬───────┴───────┬────────────┐
          ▼        ▼               ▼            ▼
      CLAUDE.md  AGENTS.md  .cursorrules  GEMINI.md
      (Claude)   (Codex)      (Cursor)    (Gemini)

Quick Start

bunx faf-mcp

Add to your MCP config:

{"mcpServers": {"faf": {"command": "bunx", "args": ["faf-mcp"]}}}
PlatformConfig File
Cursor~/.cursor/mcp.json
Windsurf~/.codeium/windsurf/mcp_config.json
ClineCline MCP settings
VS CodeMCP extension config
Claude DesktopUse claude-faf-mcp

Three Ways to Deploy

DoorMethodBest For
Hostedmcpaas.liveZero-install, point any MCP client to the URL
Self-DeployDeploy to VercelYour own instance, full control
Localbunx faf-mcpIDE integration via stdio transport

Hosted (mcpaas.live)

Point your MCP client to https://mcpaas.live/sse — no install, no config, no maintenance. Served from 300+ Cloudflare edges with sub-ms cold starts via 2.7KB Zig-WASM engine.

Self-Deploy (Vercel)

Deploy your own MCP server on Vercel in one click. Once deployed, your server exposes:

  • /health — Health check
  • /info — Server metadata + tool list
  • /sse — MCP Server-Sent Events transport

Local (npm)

npx faf-mcp

Interop Tools

ToolPlatformAction
faf_agentsOpenAI CodexImport/export/sync AGENTS.md
faf_cursorCursor IDEImport/export/sync .cursorrules
faf_geminiGoogle GeminiImport/export/sync GEMINI.md
faf_conductorConductorImport/export directory structure
faf_gitGitHubGenerate .faf from any repo URL
# Sync to all formats at once
faf bi-sync --all

# Generate .faf from any GitHub repo
faf_git { url: "https://github.com/facebook/react" }

25 MCP tools (with CLI fallback) · 309 tests (9 suites) · 7 bundled parsers


Cloud Sync

Share your FAF context globally via mcpaas.live:

ToolPurpose
faf_cloud_publishUpload to cloud, get shareable URL
faf_cloud_fetchPull context from cloud
faf_cloud_listList available souls
faf_cloud_searchSearch across souls
faf_cloud_shareGenerate share links

Example Workflow:

# Upload your project.faf
faf_cloud_publish { soul_name: "my-project" }
→ https://mcpaas.live/souls/my-project

# Anyone can fetch it
faf_cloud_fetch { soul_name: "my-project" }
→ Context merged into local project.faf

Zero-install sharing - Recipients need no MCP setup. Served from 300+ Cloudflare edges with <1ms cold starts via 2.7KB Zig-WASM engine.


Eternal Bi-Sync

Your .faf file and your platform context files stay synchronized in milliseconds.

project.faf  ←── 8ms ──→  .cursorrules / AGENTS.md / CLAUDE.md / GEMINI.md
                    Single source of truth
  • Update either side → both stay aligned
  • --all flag syncs to all four formats at once
  • Zero manual maintenance
  • Works across teams, branches, sessions

AI assistants forget. They drift. Every new session, AI starts guessing again. Bi-sync means context never goes stale.


Tier System: From Blind to Optimized

TierScoreStatus
🏆 TROPHY100%AI never has to guess
★ GOLD99%+1 slot from Trophy
◆ SILVER95%+Close — keep going
◇ BRONZE85%+Interim — keep going
● GREEN70%+Interim — keep going
● YELLOW55%+AI flipping coins
○ RED<55%AI working blind
♡ WHITE0%No context at all

At 55%, AI is guessing half the time. At 100%, AI is optimized.


use>faf | Prompt Pattern

Start every prompt with "Use FAF" to invoke MCP tools:

Use FAF to initialize my project
Use FAF to score my AI-readiness
Use FAF to sync my context
Use FAF to enhance my project

Works on all platforms — stops web search, forces tool usage.


25 Core MCP Tools

ToolPurpose
faf_initInitialize project.faf
faf_scoreCheck AI-readiness (0-100%)
faf_syncSync context across platforms
faf_bi_syncBi-directional .faf ↔ CLAUDE.md
faf_enhanceIntelligent enhancement
faf_readParse and validate FAF files
faf_writeCreate/update FAF with validation
Interop Tools
faf_agentsImport/export/sync AGENTS.md
faf_cursorImport/export/sync .cursorrules
faf_geminiImport/export/sync GEMINI.md
faf_conductorImport/export directory structure
faf_gitGenerate .faf from GitHub repo URL
Cloud Tools
faf_cloud_publishUpload to mcpaas.live
faf_cloud_fetchPull from cloud
faf_cloud_listList souls
faf_cloud_searchSearch souls
faf_cloud_shareGenerate share links

Plus 36 advanced tools and CLI fallback (via faf-cli v5.0.1):

  • faf readme - Extract 6 Ws from README (+25-35% boost)
  • faf human-add - Non-interactive YAML merge (6Ws Builder)
  • faf git - GitHub repo analysis without cloning
  • And 40+ more commands...

Ecosystem


License

MIT License — Free and open source


Zero drift. Eternal sync. AI optimized. 🏆

"It's so logical if it didn't exist, AI would have built it itself" — Claude

Ver o original no GitHub

Bom para

Relacionados