claude-faf-mcp 是一个面向 Claude 的 MCP（Model Context Protocol）服务器，用于为项目提供持久化、可版本化的 AI 上下文。它基于 IANA 注册的 .faf（Foundational AI-context Format，应用类型 application/vnd.faf+yaml）与 .fafm（应用类型 application/vnd.fafm+yaml）格式，把项目信息定义在一个文件中，供 AI 跨会话读取。官方口号是「FAF defines. MD instructs. AI codes.」——FAF 负责定义，MD 负责指示，AI 负责编码。
用途核心是解决每次会话都需重复向 AI 解释「这个项目是什么」的问题。.faf 文件随代码提交到仓库，Claude 每次会话启动时即可获得项目的技术栈、目标和相关上下文。它还能通过 faf_sync 从 .faf 生成项目 CLAUDE.md（只维护由 faf 管理的区块，不动用户自己的笔记），并通过 faf_tri_sync 同步到 MEMORY.md，实现 .faf → CLAUDE.md → MEMORY.md 的三方同步，让 AI 跨会话记住项目。
主要能力与工具集：默认列出 Core 14 个 MCP 工具，覆盖项目上下文生命周期；设置环境变量 FAF_TOOLS=all 后会显示 Extended 工具，共 30 个。无论是否设置该变量，所有工具都可按名称调用。附带的 2 个提示词中，faf prompt 可以在宿主机的提示词列表中选择（例如 Claude Code 显示为 /mcp__<server name>__faf），它会为项目评分、用仓库中可获取的事实填充、只向用户询问只有用户能回答的内容，然后验证并同步。评分方面，claude-faf-mcp 7 使用 faf-cli 8 的 always-33 内核，与 faf-cli、faf-kernel 给出相同分数；全部 33 个 Mk4 槽位由一个 Rust 内核处理。未包含 12 个企业槽位（infra、app、ops 等）slotignored 标记的 .faf 会按 33 个槽位评分（例如 21 个已填 = 64%），运行 faf_auto 会写入这些标记，分数可回到 100%（官方示例显示 56% → 100%）。
使用方式：需要 Node 22 或更高版本。Claude Desktop 用户可下载 .mcpb 扩展文件（claude-faf-mcp-7.0.1.mcpb）一键安装，扩展内置服务器，启动时不依赖 npx 或网络，并列出 Core 14 工具；也可在 claude_desktop_config.json 中配置 npx，或全局安装后使用已安装的 bin（{ "command": "claude-faf-mcp" }）；若 Bun 在 Claude Desktop 的 PATH 中，也可用 { "command": "bunx", "args": ["claude-faf-mcp"] }。npx 配置与 faf_setup 安装的 SessionStart hook（npx -y claude-faf-mcp --session-refresh）不锁定版本，会运行最新版本；若要固定在某个主版本，需自行在配置中写 "args": ["-y", "claude-faf-mcp@6"]。.mcpb 则运行构建时的版本。faf-cli 可在任意终端使用，同样的 .faf 文件适用于 Claude、Gemini、Grok、Cursor 等不同平台。
工作流程示例：安装后运行 faf prompt，Claude 会为项目评分、尽可能用仓库事实填充、只问用户才能回答的问题（例如 3Ws：Who、What、Why；6Ws 则增加 Where、When、How），验证后同步。3Ws 用于启动项目，6Ws 用于将 AI 优化到 100%。用户也可直接告诉 Claude：「I'm building [what] for [who] because [why]」。
适用场景：面向在 Claude Code 中工作的个人开发者与团队。团队场景下 .faf 随代码提交，每个会话都有基础上下文；安装原生 SessionStart hook（faf_setup，先预览，保留用户设置）后，每次 Claude Code 会话会以一行心跳信息开头，包含项目技术栈与分数，以及代码无法传达的意图（+N，即目标与 6Ws）。评分是确定性的，相同 .faf 在任何机器和 CI 中结果一致。工具本身完全本地运行，无账号、无遥测、不向 FAF 发送数据；唯一的网络使用是 faf_git，且仅在用户要求读取某个仓库时才按其给出的 URL 进行 git clone。隐私政策中列出了它写入的文件。新增成员只需 git clone 即可获得上下文。
重要版本变更：7.0.0 是重大版本，评分可能变化；7.0.1（Always33 版）内置 faf-cli 8.0.1，支持 pnpm 安装，并移除了 fast-uri 相关的两个中危公告。v6.0.0（Earned Badge Edition）起组合 faf-cli，只触碰自己写入的内容，所有写入原子且走 faf-cli 的安全路径，拒绝链接到项目外部的文件，project.faf 编辑保留注释和精确值，soul.fafm 与 Claude 自己的 MEMORY.md 笔记保持不变。6.0.0 已退役 faf_clear、faf_friday、faf_guide、faf_write、对 project.faf 的 AGENTS.md / .cursorrules / GEMINI.md / conductor 导入以及 faf_check protect/unlock；按名称调用退役工具会返回一行说明建议改用哪个工具。相关工具与格式的论文引用、MIT 开源许可、MCP Registry 编号（#2759，one.faf/claude-faf-mcp）等信息均在仓库中提供。企业/团队版计划在 faf.one/pro 中列出（对开发者免费）。
