claude-faf-mcp

概述

claude-faf-mcp 是一个实现 FAF (Forever After Format) 协议的 MCP 服务器，为 Claude 提供持久项目上下文。它使开发者能够通过标准化的 .faf 格式文件在多个会话间维持准确的项目理解。该服务器包含 33 个工具，涵盖项目初始化、验证、评分、同步和文件操作。它支持与 CLAUDE.md 的双向同步，并可选择与 MEMORY.md 进行三向同步以增强上下文保持能力。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• faf_init

  Initialize project DNA

  试试:Initialize my project with FAF试试:Create a new .faf file for my project
• faf_auto

  Auto-detect stack and populate context

  试试:Auto-detect my project stack试试:Populate context automatically for my project
• faf_readme

  Extract context from README

  试试:Extract context from my README试试:Analyze my README for project information
• faf_score

  AI-readiness score (0-100%) with breakdown

  试试:Score my project for AI readiness试试:Get a breakdown of my project's AI score
• faf_sync

  Sync .faf → CLAUDE.md

  试试:Sync my .faf file to CLAUDE.md试试:Update CLAUDE.md with my project context
• faf_tri_sync

  Tri-sync .faf ↔ CLAUDE.md ↔ MEMORY.md

  试试:Enable tri-sync for my project试试:Sync all three context files
• faf_agents

  Import/export AGENTS.md (OpenAI Codex)

  试试:Export my project context to AGENTS.md试试:Import context from AGENTS.md
• faf_read

  Read any file

  试试:Read the main.js file试试:Show me the contents of package.json
• faf_write

  Write any file

  试试:Write to a new file试试:Update the README with new information
• faf_status

  Project status overview

  试试:Show my project status试试:Get an overview of my project
• faf_doctor

  Diagnose and fix common issues

  试试:Diagnose my project issues试试:Fix common FAF problems
• faf_git

  Extract context from any GitHub repo URL

  试试:Analyze this GitHub repository试试:Get context from https://github.com/user/repo

可对比工具

安装

claude mcp add --transport http claude-faf-mcp https://claude-faf-mcp.vercel.app/sse

npm install -g claude-faf-mcp

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

npx faf-cli auto

FAQ

FAF 格式是什么？

FAF (Forever After Format) 是一个标准化 YAML 格式，通过回答关键问题（谁、什么、为什么、哪里、何时、如何）来捕获项目上下文。它已在 IANA 注册为 application/vnd.faf+yaml。

持久上下文如何工作？

服务器通过双向同步（.faf ↔ CLAUDE.md）或三向同步（.faf ↔ CLAUDE.md ↔ MEMORY.md）维持上下文，确保即使 Claude Desktop 重启后，AI 也能记住你的项目。

claude-faf-mcp 对比