.FAF Context
**Persistent Project Context for Cursor, IDEs and VS Code. Define once. Sync everywhere.** npm: `faf-mcp`
Главная: wolfe-jam.github.io/faf-mcp · Endpoint MCP на хостинге: https://ide.faf.one/mcp/v1 (HTTP с потоковой передачей)
MCP, который вы ещё не осознали необходимость, или хотели, но не знали, к кому обратиться, — он здесь. Опираясь на более чем 100k загрузок в экосистеме (последние данные), мы представляем faf-mcp, чтобы снять проблему синхронизации и обеспечить ваш выбранный AI оптимизированным контекстом по запросу.
⭐ Звезда помогает другим разработчикам находить faf-mcp — несмотря на число загрузок, примерно 3 из 4 разработчиков сначала смотрят на звёзды.
Что нового в 2.3.0 — Курированное издание
Инструменты, которые действительно нужны, прямо на виду. faf-mcp теперь по умолчанию выводит 15 основных инструментов — чистая, сфокусированная поверхность вместо стены опций. Нужно всё? Установите FAF_TOOLS=all для полного набора 29 (каждый инструмент остаётся доступен по имени в любом случае). И описание каждого Core-инструмента переработано, чтобы ваш AI выбирал нужный инструмент с первого раза.
Задайте один раз. Синхронизируйте повсюду.
Вы храните .cursorrules. Ваш коллега использует AGENTS.md. Кто-то в команде только что перешёл на Gemini. Каждому инструменту AI нужен свой контекстный файл — и все они говорят одно и то же в разных форматах.
faf-mcp — специализированный MCP-сервер для Cursor, Windsurf, Cline, VS Code и каждой платформы, кроме Claude. Один файл .faf в вашем репозитории, синхронизируемый со всеми форматами, которые нужна команде.
Контекст для Cursor & IDE агентов: faf-cli (v7.1) формирует файлы, которые синхронизирует этот сервер — bunx faf export --agents, установка нуль и нативная работа через git. См. FAF-CLI для Cursor & IDE агентов 👀.
project.faf
│
┌────────┬───────┴───────┬────────────┐
▼ ▼ ▼ ▼
CLAUDE.md AGENTS.md .cursorrules GEMINI.md
(Claude) (Codex) (Cursor) (Gemini)
Быстрый старт
Cursor — один клик:
Повсюду:
bunx faf-mcp
Добавьте в вашу MCP-конфигурацию:
{"mcpServers": {"faf": {"command": "bunx", "args": ["faf-mcp"]}}}
| Платформа | Файл конфигурации |
|---|---|
| Cursor | ~/.cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Cline | Cline MCP settings |
| VS Code | MCP extension config |
| Claude Desktop | Use claude-faf-mcp |
Три способа развёртывания
| Способ | Метод | Лучшее применение |
|---|---|---|
| Hosted | mcpaas.live | Никакой установки, укажите любой MCP-клиент на URL |
| Self-Deploy | Развернуть на Vercel | Ваш собственный инстанс, полный контроль |
| Local | bunx faf-mcp | Интеграция IDE через stdio-транспорт |
Hosted (mcpaas.live)
Укажите ваш MCP-клиент на https://ide.faf.one/mcp/v1 — без установки, без конфигурации, без обслуживания. Размещено на 300+ узлах Cloudflare с холодными стартами менее 1 мс благодаря движку Zig-WASM размером 2.7KB.
Self-Deploy (Vercel)
Разверните свой собственный MCP-сервер на Vercel в один клик. После развёртывания ваш сервер предоставляет:
/health— Проверка состояния/info— Метаданные сервера и список инструментов/mcp/v1— MCP потоковый HTTP-транспорт
Local (npm)
npx faf-mcp
Инструменты интеграции
| Инструмент | Платформа | Действие |
|---|---|---|
| faf_agents | OpenAI Codex | Импорт/экспорт/синхронизация AGENTS.md |
| faf_cursor | Cursor IDE | Импорт/экспорт/синхронизация .cursorrules |
| faf_gemini | Google Gemini | Импорт/экспорт/синхронизация GEMINI.md |
| faf_conductor | Conductor | Импорт/экспорт структуры директорий |
| faf_git | GitHub | Авторизация .faf из любого URL репозитория |
# Синхронизация во все форматы сразу
faf bi-sync --all
# Генерация .faf из любого GitHub репозитория
faf_git { url: "https://github.com/facebook/react" }
Core tier: 15 основных инструментов показываются по умолчанию; установите FAF_TOOLS=all для полного набора из 29 (каждый инструмент по-прежнему доступен по имени) · с CLI fallback · 9 тестовых наборов · 7 встроенных парсеров
Облачная синхронизация
Делитесь своим FAF контекстом глобально через [mcpaas.live]:
| Инструмент | Назначение |
|---|---|
| faf_cloud_publish | Загрузить в облако, получить shareable URL |
| faf_cloud_fetch | Получить контекст из облака |
| faf_cloud_list | Список доступных souls |
| faf_cloud_search | Поиск по контекстам |
| faf_cloud_share | Генерировать ссылки для совместного доступа |
Пример рабочего процесса:
# Загрузите ваш project.faf
faf_cloud_publish { soul_name: "my-project" }
→ https://mcpaas.live/souls/my-project
# Любой может получить его
faf_cloud_fetch { soul_name: "my-project" }
→ Контекст слит в локальный project.faf
Совместное использование без установки — Получатели не нуждаются в настройке MCP. Размещено на 300+ точках Cloudflare с холодными стартами менее чем за 1 мс благодаря движку Zig-WASM размером 2.7KB.
Вечная би-синхронизация
Ваш файл .faf и файлы контекстов платформ остаются синхронизированными за миллисекунды.
project.faf ←── 8ms ──→ .cursorrules / AGENTS.md / CLAUDE.md / GEMINI.md
Единственный источник правды
- Обновление с любой стороны → обе остаются в согласии
- Флаг
--allсинхронизирует сразу во все четыре формата - Никакого ручного обслуживания
- Работает между командами, ветками, сессиями
AI-помощники забывают. Они дрейфуют. Каждая новая сессия ИИ начинает гадать заново. Bi-sync означает, что контекст никогда не устаревает.
Система уровней: от слепоты к оптимизации
| Уровень | Очки | На каком языке |
|---|---|---|
| 🏆 TROPHY | 100% | ИИ никогда не будет гадать |
| ★ GOLD | 99%+ | 1 место от Trophy |
| ◆ SILVER | 95%+ | Близко — продолжайте |
| ◇ BRONZE | 85%+ | Промежуточно — продолжайте |
| ● GREEN | 70%+ | Промежуточно — продолжайте |
| ● YELLOW | 55%+ | AI гадает наполовину |
| ○ RED | <55% | ИИ работает «на глаз» |
| ♡ WHITE | 0% | Нет контекста вовсе |
При 55% ИИ угадывает наполовину. При 100% ИИ оптимизирован.
use>faf | Шаблон подсказки
Начинайте каждый запрос с "Use FAF" чтобы вызвать инструменты MCP:
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
Работает на всех платформах — прекращает веб-поиск, принуждает использовать инструменты.
29 MCP-инструментов
| Инструмент | Назначение |
|---|---|
| faf_init | Инициализация project.faf |
| faf_score | Проверка AI-г readiness (0-100%) |
| faf_sync | Синхронизация контекста между платформами |
| faf_bi_sync | Bi-directional .faf ↔ CLAUDE.md |
| faf_read | Разбор и проверка FAF-файлов |
| faf_write | Создание/обновление FAF с валидацией |
| Интероп-инструменты | |
| faf_agents | Импорт/экспорт/синхронизация AGENTS.md |
| faf_cursor | Импорт/экспорт/синхронизация .cursorrules |
| faf_gemini | Импорт/экспорт/синхронизация GEMINI.md |
| faf_conductor | Импорт/экспорт структуры директорий |
| faf_git | Автор .faf из URL репозитория GitHub |
| Облачные инструменты | |
| faf_cloud_publish | Загрузить в mcpaas.live |
| faf_cloud_fetch | Получить из облака |
| faf_cloud_list | Список контекстов |
| faf_cloud_search | Поиск по контекстам |
| faf_cloud_share | Генерировать ссылки для совместного доступа |
Плюс CLI-подстановка (через faf-cli):
faf readme- Извлечение 6W из README (+25-35% бонус)faf human-add- Непрямое слияние YAML (6Ws Builder)faf git- Анализ репозитория GitHub без клонирования- И ещё более 40 команд...
Экосистема
- claude-faf-mcp — Claude Desktop (33 инструмента)
- faf-cli — Терминальная CLI
- faf-wasm — WASM SDK (<5ms скоринга)
- faf.one — Официальный сайт
Если faf-mcp оказалась полезной, подумайте о звёздочке репозитория — она помогает другим найти её.
Лицензия
MIT License — Свободное и открытое ПО
Zero drift. Eternal sync. AI optimized. 🏆
"It's so logical if it didn't exist, AI would have built it itself" — Claude