Claude-FAF-MCP

Único Servidor MCP de Contexto de Proyecto Persistente - Registro Oficial de Anthropic

Documentación

claude-faf-mcp — La Edición Compose

Inicio: faf.one/mcp Demo en vivo: claude.faf.one

Contexto de Proyecto Persistente con Memoria, en bucle para ti. Configuración en un clic. 30 segundos. 🐘 Nelly Nunca Olvida.

FAF define. MD instruye. AI codifica.

⭐ Márcalo como favorito para ti, ayuda a otros desarrolladores a encontrarlo también.

Lector conforme a v0.2 del Contrato de Ingestión de Contexto FAF.

🐘 tri-sync | .faf ↔ CLAUDE.md ↔ MEMORY.md en un solo comando.

⚡ Nuevo: prompt /faf — escribe /faf en Claude Desktop. Revisa tu proyecto, lo puntúa, lo lleva al 100% y sincroniza. Incansablemente. Un solo comando.

v5.21.0 — La Edición Compose. Las Ediciones de Idioma llegan por composición — fija faf-cli ^7.7.0 para que el Núcleo faf_auto herede el carril CLI (Dart · Go · C# · JVM · Ruby · Swift); 12 herramientas del Núcleo; faf_enhance eliminado. Turbo-Cat permanece en faf-cli; CFM no bifurca detectores. E2E permanente: tests/wjttc-edition-compose.test.ts. Precedente de MCP hermano: docs/compose-faf-cli.md.

v5.20.0 — La Edición Registro de GitHub. claude-faf-mcp se une al Registro MCP de GitHub — visible en VS Code — como Claude FAF, su título de visualización ahora emitido desde project.faf, de fuente única e idempotente. El registro deriva un nombre de visualización de la tarjeta de servidor title; CFM ahora lo proporciona a través del emisor (name + _meta + title, todo compuesto desde project.faf, nunca escrito a mano — la prueba BRAKE B1 impone emitido == en vivo).

v5.15.0 — La Edición Instrucciones. CFM escribe el archivo que Copilot lee — bien hecho. .github/copilot-instructions.md ahora son instrucciones genuinas y distintas de Copilot: una descripción general en prosa, una sección de comandos ## Build & run y un marco de "cada solicitud" — no el contenido de AGENTS.md reutilizado. El archivo que Copilot realmente lee, hecho según la especificación de GitHub.

v5.14.1 — La Edición Copilot. FAF ahora escribe el archivo que GitHub Copilot lee — desde dentro de Claude. El Núcleo faf_sync gana una bandera copilot (all la incluye), sincronizando .github/copilot-instructions.md — el archivo de instrucciones de superficie más amplia de Copilot, leído por defecto en chat web, revisión de código, VS Code, JetBrains, la CLI y el agente de codificación — directamente desde tu .faf puntuado. faf_sync ahora emite cada formato (agents/cursor/gemini/copilot/all) desde la superficie predeterminada; el redundante faf_bi_sync se retira. No destructivo, idempotente.

🧡 v5.13.0 — La Edición Latido. Contexto de Proyecto Persistente con Memoria, en bucle para ti. Cada sesión de Claude Code ahora se abre con un latido de una línea que lleva la intención que el código no puede: faf: context ✪ 100% — fresh · +7 intent the code can't carry. El +N es la meta y las 6W que solo tú puedes dar o confirmar — para que Claude comience cada sesión fundamentado en lo que tu proyecto significa, no solo en lo que contiene.

🏆 v5.12.0 — La Edición Prueba. faf_bench demuestra la mejora de fundamentación de FAF en sesión — le pregunta a Claude sobre tu repositorio en frío (sin contexto) y con el .faf, califica mecánicamente (sin juez) y emite un recibo ✪ que muestra el delta. Promovido para liderar el nivel Núcleo (13 herramientas, 36 en total). faf_go ahora arranca un repositorio en frío (init → auto → 6W), y aún puedes simplemente escribir faf para comenzar. Prueba, no discurso.

🏆 v5.11.0 — La Edición Destilada. claude-faf-mcp, destilado — un Núcleo curado de 12 herramientas autodocumentadas, con la entrevista, el extractor de README y la tarjeta de servidor todo compuesto desde la fuente única de faf-cli (sin bifurcaciones), y la nueva Tabla-de-8 de faf_go donde tu meta siembra las 6W. Menos herramientas, nada bifurcado, nada adivinado.

Contexto para Claude: faf-cli mantiene el CLAUDE.md / AGENTS.md de este MCP sincronizado desde una fuente puntuada — bunx faf sync. Ver FAF-CLI para Claude Code 👀.

🏆 Piso de Compose faf-cli ^7.7.0. Las Ediciones de Idioma (Dart · Go · C# · JVM · Ruby · Swift) llegan por composición — Turbo-Cat en faf-cli; CFM no bifurca detectores. Sube la dependencia, vuelve a probar, publica. Precedente para MCP hermanos: docs/compose-faf-cli.md.

🏆 v5.10.0 — La Edición Dart. claude-faf-mcp ahora lee Dart y Flutter — sabe distinguir una app Flutter de un CLI de Dart puro. Detección por composición: porque CFM compone el Turbo-Cat de faf-cli (La Edición con Fuente), el clasificador Dart de faf-cli 6.13.0, consciente del contenido e impulsado por pubspec, llega por construcción — sin parser bifurcado, sin desviación.

🏆 v5.9.0 — La Edición con Fuente. Cada respuesta proviene de una sola fuente. faf_go y la detección Turbo-Cat ahora componen los motores de fuente única de faf-cli en lugar de llevar sus propias copias — los rellenos provienen de evidencia real o permanecen honestamente vacíos, nada adivinado. El extractor de adivinanzas heredado se ha ido; el prompt /faf impulsa a un 100% verificado (recibo de paridad faf_trust + ✪) y lo mantiene fresco. FAF no miente, por construcción.

🏆 v5.8.0 — La Edición Confianza. Contexto nativo de Claude Code que simplemente funciona. Un hook nativo de SessionStart abre cada sesión con contexto fresco y un latido ✪ de una línea (faf: context ✪ 100% — fresh); la salida de herramientas es silenciosa (sin emojis, analizable) y tipada (structuredContent en todas partes); cada puntuación lleva un hash de paridad determinista que cualquier motor puede reproducir, sellado en un recibo ✪ autoverificable. Instalado explícitamente vía faf_setup — vista previa primero, tus ajustes preservados. Construido sobre la base Canónica: acceso a archivos confinado a rutas, remoto edge-direct, 35 herramientas.

12 herramientas MCP del Núcleo (34 con FAF_TOOLS=all). Formatos registrados en IANA (application/vnd.faf+yaml · application/vnd.fafm+yaml). 592 pruebas por suite.

Las 3W — 3 Respuestas. Eso es Todo.

Cada gran producto comenzó con 3 respuestas a las 3W — Quién, Qué, Por qué:

	¿PARA QUIÉN es?	¿QUÉ hace?	¿POR QUÉ construirlo?
Uber	Personas que necesitan un viaje	Toca un botón, llega un auto	Los taxis estaban rotos
Airbnb	Viajeros que no pueden pagar hoteles	Quédate en la habitación libre de alguien	Millones de habitaciones vacías existen
Slack	Equipos ahogados en correos	Mensajería grupal organizada	Decisiones enterradas en hilos
Venmo	Amigos dividiendo cuentas	Envía dinero al instante	Alguien siempre olvida pagar

Mismo patrón. Cada producto que funciona comienza aquí. .faf lo captura:

human_context:
  who: "people who need a ride across town"
  what: "tap a button, car arrives in minutes"
  why: "taxis are slow, expensive, and hard to find"

30 segundos. Claude construye tu project.faf a partir de esto. Cada sesión después, la IA comienza inteligente.

Las 6W — Para IA Optimizada

Las 3W te ponen en marcha. Para IA completamente optimizada, completa el conjunto — Dónde, Cuándo, Cómo:

  where: "mobile app, iOS and Android"    # where does it live?
  when: "launch in 3 months"              # when is it shipping?
  how: "GPS matching, real-time pricing"  # how does it work?

Las 3W inician el proyecto con IA. Las 6W optimizan la IA al 100%. Mismo YAML, mismo archivo. Más ejemplos → faf.one/ideas

Inicio Rápido

faf-cli — universal (cualquier IA)

npx faf-cli auto

Mismo .faf, cada superficie — Claude, Gemini, Grok, Cursor. faf-cli en npm →

Claude Desktop — clic, copiar, pegar, instalar

Clic — .mcpb de un clic

⬇ Descargar claude-faf-mcp-5.21.0.mcpb

Doble clic. Cero Configuración — sin terminal, sin configuración JSON. 12 herramientas del Núcleo viven en 10 segundos.

Copiar — prompt de pegado para Claude

Instala el servidor MCP FAF: npm install -g claude-faf-mcp, luego agrega esto a mi claude_desktop_config.json: {"mcpServers": {"faf": {"command": "bunx", "args": ["claude-faf-mcp"]}}} y reinicia Claude Desktop.

Pegar — claude_desktop_config.json

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

Instalar — npm manual

npm install -g claude-faf-mcp

Smithery: wolfe-jam/claude-faf-mcp — alojado en https://mcpaas.live/claude/mcp/v1

Reinicia Claude Desktop.

Luego

Escribe /faf — Claude revisa tu proyecto, lo puntúa, lo lleva al 100% y sincroniza. Hecho.

O dile a Claude tus 3W: "Estoy construyendo [qué] para [quién] porque [por qué]"

Cómo Funciona

You → 3 answers → project.faf → AI reads it → every session → forever

project.faf  ←── 8ms ──→  CLAUDE.md     (bi-sync, free)
project.faf  ←── 8ms ──→  MEMORY.md     (tri-sync, Pro 🐘)

Claude hace el resto. Cero esfuerzo, bien a la primera, rápido, preciso, hecho. Idioma, framework, gestor de paquetes, herramientas de compilación — todo auto-detectado desde tus archivos existentes. El contexto humano es la parte que solo tú puedes dar.

Para equipos de Claude Code

.faf vive en el repositorio. Tu contexto viaja con el código — confirmado, versionado, hecho.

Cada sesión comienza fundamentada. Instala el hook nativo de SessionStart una vez (faf_setup — vista previa primero, tus ajustes preservados). Después de eso, cada sesión de Claude Code se abre con un latido de una línea en lugar de una pizarra en blanco:

faf: context ✪ 100% — fresh · +7 intent the code can't carry

Esa línea es el relevo: Claude ya conoce tu stack y tu puntuación — y el +N es la intención que el código no puede llevar: la meta y las 6W que solo tú puedes dar o confirmar. Sin re-explicar "qué es este proyecto" al inicio de cada sesión.

Escala al equipo por construcción:

commit project.faf  →  every teammate's Claude starts with the same context
git clone           →  a new dev's Claude is grounded before they write a line

Una sola fuente de verdad. .faf ↔ CLAUDE.md permanecen sincronizados (bi-sync). Agrega MEMORY.md para memoria entre sesiones (tri-sync 🐘).
Sin desviación. La puntuación es determinista — mismo .faf, mismo número, en cada máquina y en CI. Un compañero no puede estar accidentalmente menos fundamentado que tú.
Local y privado. Nada sale de la máquina — sin cuentas, sin telemetría. El contexto es tuyo; solo viaja en el repositorio.

La incorporación se convierte en git clone → fundamentada. El contexto que un nuevo compañero normalmente recogería preguntando ya está en el repositorio, legible por máquina, desde el primer clon.

Puntuación: De Ciego a Optimizado

Nivel	Puntuación	Qué significa
🏆 TROFEO	100%	Código de Oro — IA optimizada
★ ORO	99%+	Contexto casi perfecto
◆ PLATA	95%+	Excelente
◇ BRONCE	85%+	Listo para producción
● VERDE	70%+	Base sólida
● AMARILLO	55%+	IA lanzando monedas
○ ROJO	<55%	IA trabajando a ciegas
♡ BLANCO	0%	Sin contexto alguno

Al 55%, la IA adivina la mitad del tiempo. Al 100%, la IA conoce tu proyecto. Mismo compilador que faf-cli — misma puntuación en todas partes.

Herramientas MCP — 12 del Núcleo, 34 con `FAF_TOOLS=all`

Por defecto, claude-faf-mcp anuncia un Núcleo destilado de 12 — las herramientas del ciclo de vida que buscas, cada una autodocumentada. Establece FAF_TOOLS=all para exponer herramientas Extendidas (llamables por nombre independientemente). Núcleo 12: faf_init · faf_auto · faf_go · faf_bench · faf_score · faf_doctor · faf_sync · faf_context · faf_trust · faf_about · faf_etch · faf_recall. (faf_enhance eliminado — sin reescritura silenciosa de IA de project.faf.)

Todas las herramientas funcionan de forma independiente — cero dependencias CLI, 19ms de ejecución promedio.

Crear y Detectar

Herramienta	Propósito
`faf_init`	Inicializar el ADN del proyecto
`faf_auto`	Auto-detectar el stack y poblar el contexto
`faf_quick`	Creación ultrarrápida (3ms)
`faf_readme`	Extraer contexto del README (impulso +25-35%)
`faf_formats`	Descubrir todos los formatos en tu proyecto
`faf_git`	Extraer contexto de cualquier URL de repositorio GitHub
`faf_human_add`	Agregar contexto humano (las 6W)

Validar y Puntuar

Herramienta	Propósito
`faf_score`	Puntuación de preparación para IA (0-100%) con desglose
`faf_bench`	Benchmark de fundamentación de IA — frío vs .faf, con un recibo `✪`
`faf_check`	Validar la estructura .faf
`faf_doctor`	Diagnosticar y corregir problemas comunes
`faf_go`	Entrevista guiada hacia Código de Oro
Sincronizar y persistir
Herramienta	Propósito
------	---------
`faf_sync`	Sincroniza .faf → CLAUDE.md — `agents`/`cursor`/`gemini`/`copilot`/`all` también emiten AGENTS.md / .cursorrules / GEMINI.md / copilot-instructions.md
`faf_tri_sync`	Tri-sincronización .faf ↔ CLAUDE.md ↔ MEMORY.md — Función Pro, gratuita para desarrolladores 🐘

Exportar e interoperar

Herramienta	Propósito
`faf_agents`	Importar/exportar AGENTS.md (OpenAI Codex)
`faf_cursor`	Importar/exportar .cursorrules (Cursor IDE)
`faf_gemini`	Importar/exportar GEMINI.md (Google Gemini)
`faf_conductor`	Importar/exportar directorio Conductor

Leer y escribir

Herramienta	Propósito
`faf_read`	Leer cualquier archivo
`faf_write`	Escribir cualquier archivo
`faf_status`	Resumen del estado del proyecto
`faf_debug`	Inspección del entorno
`faf_about`	¿Qué es .faf?

Referencia completa de herramientas →

🐘 Nelly nunca olvida

bi-sync mantiene .faf ↔ CLAUDE.md alineados.

tri-sync añade MEMORY.md — tu IA recuerda tu proyecto en cada sesión.

bi-sync  = .faf ↔ CLAUDE.md              ← always in sync
tri-sync = .faf ↔ CLAUDE.md ↔ MEMORY.md  ← Nelly never forgets 🐘

Función Pro, gratuita para desarrolladores. Equipos y Empresas: faf.one/pro (planes)

La posición .FAF

Model        Context          Protocol
─────        ───────          ────────
Claude    →   .faf        →    MCP
Gemini    →   .faf        →    MCP
Codex     →   .faf        →    MCP
Any LLM   →   .faf        →    MCP

Registrado en IANA (application/vnd.faf+yaml). Funciona con cualquier IA. Define una vez, úsalo en todas partes.

Ecosistema

Paquete	Plataforma	Registro
claude-faf-mcp (este)	Claude	npm
faf-cli	CLI universal	npm + Homebrew
gemini-faf-mcp	Google Gemini	PyPI
grok-faf-mcp	xAI Grok	npm
rust-faf-mcp	Rust	crates.io
faf-wasm	Navegador/Edge	npm
Extensión de Chrome	Navegador	Chrome Web Store

Mismo project.faf. Misma puntuación. Mismo resultado. Diferente capa de ejecución.

Calidad

572 pruebas · 28 suites · 3 plataformas (bun en ubuntu/macos/windows)

Panel de CI →

Privacidad

Todo se ejecuta localmente. Ningún dato sale de tu máquina. Sin análisis, sin telemetría, sin seguimiento, sin cuentas. Política de privacidad →

Si claude-faf-mcp te ha sido útil, considera dar una estrella al repositorio — ayuda a otros a encontrarlo.

Citación

Si usas claude-faf-mcp o los formatos .faf / .fafm / .fafa en investigación o producción, por favor cita los artículos del formato:

Wolfe, J. (2025). Arquitectura de Contexto de IA Dirigida por Formato: El Estándar .faf para Comprensión Persistente de Proyectos. Zenodo. https://doi.org/10.5281/zenodo.18251362

Wolfe, J. (2026). Memoria Permanente y Recuerdo Instantáneo: El Estándar .fafm para Memoria de Agentes de IA Multi-Perfil. Zenodo. https://doi.org/10.5281/zenodo.20348942

Wolfe, J. (2026). Por Qué los Agentes Necesitan un Pasaporte: .fafa — Identidad Portátil para la Era de los Agentes. Zenodo. https://doi.org/10.5281/zenodo.21951641

BibTeX

@article{wolfe2025faf,
  title     = {Format-Driven AI Context Architecture: The .faf Standard for Persistent Project Understanding},
  author    = {Wolfe, James},
  year      = {2025},
  month     = {nov},
  publisher = {Zenodo},
  doi       = {10.5281/zenodo.18251362},
  url       = {https://doi.org/10.5281/zenodo.18251362}
}

@article{wolfe2026fafm,
  title     = {Permanent Memory and Instant Recall: The .fafm Standard for Multi-Profile AI Agent Memory},
  author    = {Wolfe, James},
  year      = {2026},
  month     = {may},
  publisher = {Zenodo},
  doi       = {10.5281/zenodo.20348942},
  url       = {https://doi.org/10.5281/zenodo.20348942}
}

@article{wolfe2026fafa,
  title     = {Why Agents Need a Passport: .fafa — Portable Identity for the Agentic Era},
  author    = {Wolfe, James},
  year      = {2026},
  month     = {aug},
  publisher = {Zenodo},
  doi       = {10.5281/zenodo.21951641},
  url       = {https://doi.org/10.5281/zenodo.21951641}
}

Licencia

MIT — Gratuito y de código abierto

Familia FAF


faf-cli	`npx faf-cli init` — crea .faf para cualquier proyecto
claude-faf-mcp	Servidor MCP para Claude Desktop
gemini-faf-mcp	Servidor MCP para Gemini CLI
grok-faf-mcp	Servidor MCP para Grok
faf-mcp	Servidor MCP para Cursor, Windsurf, Cline, VS Code
rust-faf-mcp	Servidor MCP en Rust
faf-skills	17 habilidades de Claude Code
faf.one	Blog, descargas, documentación
IANA: vnd.faf+yaml	Formato de contexto (2025-10-30)
IANA: vnd.fafm+yaml	Formato de memoria (2026-05-13)

formato | impulsado 🏎️⚡️ wolfejam.dev

Obtén la CLI

faf-cli — La CLI original de Contexto de IA. Imprescindible para cada desarrollador.

npx faf-cli auto

Anthropic MCP #2759 · 2 registros IANA: vnd.faf+yaml (Contexto) · vnd.fafm+yaml (Memoria) · faf.one · npm

Cero configuración. Contexto que simplemente está ahí — en cada sesión.