claude-faf-mcp — Издание GitHub Registry

Главная: faf.one/mcp

Демонстрация вживую: claude.faf.one

Постоянный контекст проекта с памятью, зацикленный для вас. Быстрая настройка одним щелчком. 30 секунд. 🐘 Nelly Never Forgets.

FAF определяет. MD задаёт инструкции. AI кодирует.

⭐ Звезда помогает другим разработчикам найти claude-faf-mcp — несмотря на загрузки, примерно 3 из 4 разработчиков сначала смотрят на звёзды.

v0.2-conformant reader Контракта по внедрению контекста FAF (FAF Context Ingestion Contract).

🐘 tri-sync | .faf ↔ CLAUDE.md ↔ MEMORY.md одной командой.

⚡ New: /faf prompt — введите /faf в Claude Desktop. Он проверит ваш проект, оценит его, доведёт до 100% и синхронизирует. Неумолимо. Одна команда.

v5.20.0 — Издание GitHub Registry. claude-faf-mcp присоединяется к MCP Registry GitHub — обнаруживаем в VS Code — как Claude FAF, его отображаемое название теперь берётся из project.faf, единообразно и идемпортентно. Реестр выводит отображаемое имя из server-card title; CFM теперь предоставляет его через эмиттер (name + _meta + title, всё сформировано из project.faf, никогда не прописано вручную — тест BRAKE B1 гарантирует, что emitted == live).

v5.15.0 — Издание Инструкций. CFM пишет файл, который читает Copilot — сделано правильно. .github/copilot-instructions.md теперь подлинно содержит инструкции Copilot: текстовый обзор, раздел команд ## Build & run, и рамки «каждый запрос» — не копия содержания AGENTS.md. Файл, который Copilot реально читает, создан в соответствии со спецификацией GitHub.

v5.14.1 — Издание Copilot. FAF теперь пишет файл, который читает GitHub Copilot — внутри Claude. Ядро faf_sync получает флаг copilot (all включает его), синхронизируя .github/copilot-instructions.md — документ Copilot с наибольшим охватом инструкций, читаемый по умолчанию в веб-чате, обзоре кода, VS Code, JetBrains, CLI и кодующем агенте — напрямую из вашего оценённого .faf. faf_sync теперь выдаёт каждый формат (agents/cursor/gemini/copilot/all) с дефолтной поверхности; устаревший faf_bi_sync снят с эксплуатации. Негативного влияния, идемпотентно.

🧡 v5.13.0 — Издание Heartbeat. Постоянный контекст проекта с памятью, запущенный для вас. Каждая сессия Claude Code открывается одной строкой heartbeat, несущей то, что код не может передать: faf: context ✪ 100% — fresh · +7 intent the code can't carry. Значение +N — цель, а 6Ws — только вы можете дать или подтвердить — поэтому Claude начинает каждую сессию, опираясь на то, что ваш проект значит, а не только на то, что в нём есть.

🏆 v5.12.0 — Издание Доказательств. faf_bench демонстрирует основание FAF в сессии — он задаёт Claude ваш репозиторий «холодным» образом (без контекста) и с .faf оценивает механически (без судьи) и выдает квитанцию ✪, показывающую дельту. Повышено до Core-тиры (13 инструментов, 36 всего). faf_go теперь инициализирует холодный репозиторий (init → auto → 6Ws), и вы всё ещё можете просто набрать faf для старта. Доказательство, а не призыв к покупке.

🏆 v5.11.0 — Издание в чистом виде. claude-faf-mcp, очищенное — ядро из 12 самодокументирующих инструментов, с интервью, экстрактором README и server-card, всё составлено из единственного источника faf-cli (без форков), а новая Таблица из 8 инструментов у faf_go, где ваша цель задаёт 6Ws. Меньше инструментов, ничего не форкнуто, ничего не угадывается.

Контекст для Claude: faf-cli синхронизирует CLAUDE.md / AGENTS.md этого MCP из единого оценённого источника — bunx faf sync. См. FAF-CLI for Claude Code 👀.

🏆 v5.10.0 — Издание Dart. claude-faf-mcp теперь читает Dart и Flutter — он различает Flutter-приложение от чисто Dart CLI. Обнаружение по композиции: поскольку CFM включает Turbo-Cat faf-cli (The Sourced Edition), содержательно-чуткий Dart-классификатор faf-cli 6.13.0 приходит по умолчанию — без форкнутого парсера, без дрейфа. 35 инструментов, npm-audit чист.

🏆 v5.9.0 — Издание со источником. Каждый ответ исходит из одного источника. faf_go и распознавание Turbo-Cat теперь собирают движки faf-cli как единый источник, вместо того чтобы держать собственные копии — заполнения идут из реальных данных или честно остаются пустыми, ничего не угадывается. Устаревший извлекатель-угадыватель исчез; промпт /faf приводит к проверяемой на 100% точности (faf_trust + квитанция ✪) и держит это в актуальном виде. FAF не лжёт, по сути.

🏆 v5.8.0 — Издание Доверия. Контекст Claude Code родной и безупречный. Встроенный хук SessionStart открывает каждую сессию с новым контекстом и одной строкой ✪ heartbeat (faf: context ✪ 100% — fresh); вывод инструментов тихий (без эмодзи, парсится) и строго типизированный (structuredContent повсюду); каждый балл имеет детерминированный хеш-паритет, воспроизводимый любым движком, запечатлён в самоподтверждающей квитанции ✪. Установка явно через faf_setup — сначала предварительный просмотр, ваши настройки сохраняются. Основано на канонической основе: ограниченный доступ к файлам по путям, прямой удалённый доступ, 35 инструментов.

13 Core MCP инструментов (35 с FAF_TOOLS=all). Зарегистрированные IANA форматы (application/vnd.faf+yaml · application/vnd.fafm+yaml). 1 716 тестовых прогонов на пуш.

The 3Ws — 3 Ответа. Это всё.

Каждый великий продукт начинается с трёх ответов на 3Ws — Кто, Что, Зачем:

	КТО для кого?	ЧТО делает?	ЗАЧЕМ строить?
Uber	Люди, которым нужна поездка	Нажми кнопку, машина прибудет	Такси было сломано
Airbnb	Путешественники, не могущие позволить себе отели	Расселиться в чужой свободной комнате	Миллионы пустых комнат существуют
Slack	Команды, перегруженные почтой	Организованная групповая переписка	Решения застряли в ветках обсуждений
Venmo	Друзья, делящие счета	Мгновенная передача денег	Кто-то всегда забывает вернуть деньги

Та же самая модель. Каждый работающий продукт начинается здесь. .faf фиксирует это:

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 секунд. Claude составляет ваш project.faf на основе этого. Каждый последующий сеанс — ИИ начинает эффективно.

The 6Ws — Для оптимизированного AI

3Ws запускают. Для полностью оптимизированного AI дополните набор — Где, Когда, Как:

where: "mobile app, iOS and Android"    # где живёт проект?
  when: "launch in 3 months"              # когда он выйдет?
  how: "GPS matching, real-time pricing"  # как это работает?

3Ws инициируют проект с AI. 6Ws оптимизируют AI до 100%. Тот же YAML, тот же файл. Еще примеры → faf.one/ideas

Быстрый старт

faf-cli — универсальный (для любого AI)

npx faf-cli auto

Та же .faf, для всех поверхностей — Claude, Gemini, Grok, Cursor. faf-cli на npm →

Claude Desktop — клик, копировать, вставить, установить

Клик — одно нажатие .mcpb

⬇ Скачать claude-faf-mcp-5.13.0.mcpb

Двойной клик. Никакой конфигурации — без терминала, без JSON-конфига. 13 Core инструментов за 10 секунд.

Copy — вставьте промпт в Claude

Установите FAF MCP-сервер: npm install -g claude-faf-mcp, затем добавьте в мой claude_desktop_config.json: {"mcpServers": {"faf": {"command": "bunx", "args": ["claude-faf-mcp"]}}} и перезапустите Claude Desktop.

Paste — claude_desktop_config.json

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

Install — ручной npm

npm install -g claude-faf-mcp

Smithery: wolfe-jam/claude-faf-mcp — размещён на https://mcpaas.live/claude/mcp/v1

Перезапустите Claude Desktop.

Затем

Введите /faf — Claude проверит ваш проект, оценит его, доведёт до 100% и синхронизирует. Готово.

Или скажите Claude ваши 3Ws: «Я создаю [что] для [кого], потому что [почему]»

Как это работает

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 делает остальное. Нулевые усилия, с первого раза правильно, быстро, точно, готово. Язык, фреймворк, менеджер пакетов, инструменты сборки — всё автоматически определяется по существующим файлам. Человеческий контекст — та часть, которую можете дать только вы.

Для команд Claude Code

.faf хранится в репозитории. Ваш контекст следует за кодом — зафиксирован, версионирован, готов.

Каждая сессия начинается с основанной позиции. Установите встроенный хук SessionStart один раз (faf_setup — предварительный просмотр, ваши настройки сохраняются). После этого каждая сессия Claude Code открывается одной строкой heartbeat вместо чистого листа:

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

Эта строка — реле: Claude уже знает ваш стек и ваш балл — и +N — это тот настрой, который код не может передать: цель и 6Ws — только вы можете дать или подтвердить. Не требуйте пояснения «что этот проект значит» в начале каждой сессии.

Это масштабируется для команды по умолчанию:

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

Единственный источник истины. .faf ↔ CLAUDE.md поддерживаются в синхронном режиме (bi-sync). Добавьте MEMORY.md для межсессионной памяти (tri-sync 🐘).
Без дрейфа. Балл детерминирован — одинаковый .faf, одно и то же число на любой машине и в CI. Сосед не может быть менее «осмысленным», чем вы.
Локально и приватно. Ничто не покидает машину — без учётных записей, без телеметрии. Контекст ваш; он просто живёт в репозитории.

Онбординг становится git clone → основанный контекст. Контекст, который новый участник команды обычно получал бы от коллег, уже в репозитории, машиночитаемый, с самого первого клона.

Оценка: от слепого к оптимизированному

Уровень	Балл	Что это значит
🏆 ТРОФЕЙ	100%	Золотой код — ИИ оптимизирован
★ ЗОЛОТО	99%+	Почти идеальный контекст
◆ СЕРЕБРО	95%+	Превосходно
◇ БРОНЗА	85%+	Готов к продакшену
● ЗЕЛЁНЫЙ	70%+	Надёжная база
● ЖЁЛТЫЙ	55%+	ИИ колеблется между решениями
○ КРАСНЫЙ	Wolfe, J. (2025). Форматно-ориентированная архитектура контекста ИИ: Стандарт .faf для устойчивого понимания проекта. Zenodo. https://doi.org/10.5281/zenodo.18251362

Wolfe, J. (2026). Постоянная память и мгновенное воспроизведение: Стандарт .fafm для памяти AI‑агентов с несколькими профилями. Zenodo. https://doi.org/10.5281/zenodo.20348942

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

Лицензия

MIT — свободное и открытое ПО

FAF Family


faf-cli	npx faf-cli init — создать .faf для любого проекта
claude-faf-mcp	MCP сервер для Claude Desktop
gemini-faf-mcp	MCP сервер для Gemini CLI
grok-faf-mcp	MCP сервер для Grok
faf-mcp	MCP сервер для Cursor, Windsurf, Cline, VS Code
rust-faf-mcp	MCP сервер на Rust
faf-skills	17 навыков Claude Code
faf.one	Блог, загрузки, документация
IANA: vnd.faf+yaml	Контекст (2025-10-30)
IANA: vnd.fafm+yaml	Память (2026-05-13)

format | driven 🏎️⚡️ wolfejam.dev

Получить CLI

faf-cli — оригинальный CLI для AI-Context. Необходим каждому разработчику.

npx faf-cli auto

Anthropic MCP #2759 · 2 IANA регистрации: vnd.faf+yaml (Контекст) · vnd.fafm+yaml (Память) · faf.one · npm

Нулевая конфигурация. Контекст, который просто есть — в каждой сессии.