claude-faf-mcp

claude-faf-mcp

Wolfe-JamMIT
17 звёзд7 форков
При работе с большими проектами разработчики сталкиваются с тем, что ИИ-ассистент теряет контекст после каждой сессии. Приходится заново объяснять архитектуру, требования, используемые технологии и структуру файлов. claude-faf-mcp решает эту проблему целиком. Сервер использует специальный формат .faf, зарегистрированный в реестре IANA. В этом файле хранится структурированное описание проекта: стек технологий, архитектура, принятые решения, текущие задачи. Благодаря формату AI быстро «вспоминает» всё, что нужно для качественной помощи, — без длинных промптов и повторных объяснений. Сервер автоматически синхронизирует .faf с файлами CLAUDE.md и MEMORY.md. Достаточно ввести команду /faf в чате Claude Desktop, и сервер проверит проект, оценит полноту контекста и при необходимости обновит все файлы.
ClaudeProductivity
Открыть на GitHubОфициальный сайт

Установка

npx -y claude-faf-mcp

Характеристики

Общее

  • СтатусСообщество
  • РазработчикWolfe-Jam
  • ЛицензияMIT

Технологии

  • Языки
    JavaScript
  • Транспорт
    ssestdio

Описание

Возможности

  • Ведёт профайл проекта в формате .faf — структурированное описание стека, архитектуры и текущих задач.
  • Синхронизирует контекст между тремя файлами: .faf, CLAUDE.md и MEMORY.md (Tri-sync).
  • Вычисляет оценку FAF по IANA-спецификации — AI видит, насколько полно описан проект.
  • Запускает полную проверку по команде /faf: анализ, скоринг, синхронизация.
  • Насчитывает 33 инструмента для управления знаниями проекта.
  • Соответствует двум официальным IANA-стандартам: application/vnd.faf+yaml и application/vnd.fafm+yaml.
  • Гарантирует совпадение оценок с CLI-утилитой faf score (FAF-binary v5.6.1).
  • Хранит контекст локально — данные не покидают вашу файловую систему.
  • Работает через два транспорта: stdio для десктопа и SSE для веба.

Как подключить

Установка и настройка занимают меньше минуты.

1. Установка — выполните команду в терминале проекта:

npx -y claude-faf-mcp

2. Настройка — добавьте сервер в конфигурацию MCP-клиента. Для Claude Desktop файл claude_desktop_config.json выглядит так:

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

Если используете другой клиент, укажите транспорт stdio или sse.

3. Запуск — перезапустите клиент. Наберите /faf в чате Claude, чтобы запустить проверку и синхронизацию контекста.

Примеры запросов

  • «Запусти команду /faf, чтобы проверить качество контекста и синхронизировать файлы».
  • «Сохрани текущую архитектуру проекта в формате .faf, добавь информацию о стеке React, Node.js, MongoDB».
  • «Покажи текущую оценку FAF и объясни, каких разделов не хватает для 100%».
  • «Запомни, что мы перешли с REST на GraphQL. Обнови контекст проекта во всех файлах».

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio, SSE
  • Лицензия: MIT
  • Совместимость: Claude Desktop, Cline, Continue.dev и любые MCP-хосты
  • Инструменты: 33
  • Форматы: application/vnd.faf+yaml, application/vnd.fafm+yaml (IANA)
  • Сайт: faf.one/mcp

Поделиться