← 返回目录

Claude FAF

社区

为Claude提供持久化项目上下文，采用IANA注册的.faf格式。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 272 / 438
Stars: ★ 23 热门
传输方式: stdio（本地进程）
运行环境: Node.js · Bun
凭据: 无需凭据
许可证: MIT
最近提交: 9 天前
工具数: 27

49FMRS · D

该服务器提供持久化上下文和记忆功能，集成度高，但需注意文件操作相关风险，总体价值高。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

8/20

维护活跃度

11/20

文档质量

10/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: README与manifest本身即为不可信材料，且内部相互矛盾：仓库描述称'32 tools + 1 prompt'，README标题称13 Core/35 total，正文又称'Core of 12'与'36 total'；manifest版本5.22.1与README中的mcpb下载链接(5.13.0)不一致。未提供可核验的CI workflow文件或提交的测试代码（仅徽章声明'572 tests'），按静态校准规则不得高于12分。声明'19ms平均执行''确定性评分'均无法静态验证。
安全与权限 8/20: 未发现恶意行为、凭证窃取或隐蔽外传等红线问题，README声明全本地运行、无遥测，manifest含mcpb的sha256，README还提到v5.8.0的路径受限文件访问（path-confined）。但faf_read/faf_write被描述为'Read any file / Write any file'，文件写入面过宽且未见强制的危险操作确认流程描述；faf_setup会修改用户Claude Code设置（hooks），虽有'preview first'声明但无法静态验证。扣除权限范围与确认机制的不可证实部分。
维护活跃度 11/20: 仓库未归档，MIT许可证明确，有open issue(1)且发布节奏密集（5.8→5.22多个版本），npm/mcpb/Smithery多渠道分发，manifest含repository id。但版本迭代极快且文档与manifest版本漂移，未见到SECURITY.md或安全响应渠道的证据，依赖faf-cli ^7.7.0的compose策略增加供应链面，治理信息有限。
文档质量 10/20: README详尽：安装路径、工具表、评分体系、隐私声明、引用、生态列表齐全，且有faf.one网站与mcp-tools.md引用。但存在硬伤：工具数量前后矛盾(12/13/32/35/36)、manifest与README版本不一致、'Pro feature, free for developers'的定价语义含混、README内含大量营销性不可验证声明（DOI、IANA注册号未在材料中核验），无故障排查/已知限制章节。
安装易用性 12/20: 提供了多种安装路径：.mcpb一键安装、bunx/npx配置示例、npm全局安装、Smithery托管URL，含claude_desktop_config.完整片段，主流程清晰。但README自身示例中的mcpb链接指向5.13.0而非manifest的5.22.1，且依赖bunx（非所有用户环境有bun），Smithery托管端点引入外部服务，复杂度与一致性略有扣分；静态校准上限15内评分。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码

适合谁

使用 Claude Desktop 的开发者
想要持久、版本化项目上下文
需要 AI 会话间记忆的团队

不适合谁

不需要 AI 项目上下文的个人项目
不使用支持 .faf 格式的 AI 工具
担心扩展工具的超预算用户

所需权限

读取和写入项目文件
本地执行，无网络传输

风险与副作用

文件覆盖风险，需审查每次同步
部分工具已弃用，但核心仍稳定

安装接入

准备工作

运行环境：Node.js · Bun

点击下载 .mcpb 文件并双击安装，或使用 npm install -g claude-faf-mcp，然后配置 claude_desktop_config.json 为：{"mcpServers":{"faf":{"command":"bunx","args":["claude-faf-mcp"]}}}，重启 Claude Desktop。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add faf -- bunx claude-faf-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后在 Claude Desktop 的工具列表中应出现 faf_init、faf_score 等 faf_* 工具；也可以直接输入 /faf 提示词，让服务器检查项目并给出评分，以确认连接正常。

常见排障

确保 npm 包已全局安装，检查 claude_desktop_config.json 中的命令是否正确，确保网络可访问 npm 或 GitHub，或检查 Claude 日志。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 faf_init 为这个项目初始化 project.faf
运行 faf_auto 自动检测我的技术栈并填充项目上下文
给这个项目打分：我的 AI 就绪度是多少分？
运行 faf_sync 把 .faf 同步到 CLAUDE.md

工具能力 27

faf_init 写入

初始化项目DNA。

faf_auto 写入

自动检测技术栈并填充上下文。

faf_go 写入

引导式访谈，达成黄金代码。

faf_bench 只读

对比无上下文与有.faf时的AI基础能力，生成✪收据。

faf_score 只读

AI就绪度评分（0-100%），含细分。

faf_doctor 写入

诊断并修复常见问题。

faf_sync 写入

同步.faf到CLAUDE.md或AGENTS.md等。

faf_context 只读

获取或显示当前上下文。

展开其余 19 个工具

faf_trust 只读

验证分数确定性。

faf_about 只读

解释.faf是什么。

faf_etch 写入

提取或嵌入上下文。

faf_recall 只读

回忆记忆。

faf_quick 写入

faf_readme 只读

faf_formats 只读

faf_git 只读

faf_human_add 写入

faf_check 只读

faf_tri_sync 写入

faf_agents 写入

faf_cursor 写入

faf_gemini 写入

faf_conductor 写入

faf_read 只读

faf_write 写入

faf_status 只读

faf_debug 只读

使用场景

为每次 Claude 会话提供一致的项目上下文。

让新团队成员在克隆仓库后立即获得上下文。

跨会话持久记忆项目事实。

确保 AI 遵循项目特定约定。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Claude FAF是一个MCP服务器，为Claude提供持久的项目上下文和记忆。它利用IANA注册的.faf格式（应用/vnd.faf+yaml）存储项目DNA，包括堆栈、目标和6Ws。它提供工具来初始化、自动检测、评分、同步和审计上下文，确保AI在每次会话中都能获得连贯的理解。默认提供13个核心工具，扩展可达35个。通过写入CLAUDE.md、AGENTS.md等文件，可在多AI环境中实现互操作。