Claude Faf MCP

🚀 claude-faf-mcp

claude-faf-mcp 是 .FAF（基础 AI 上下文格式）的官方 MCP 服务器，拥有 50 种工具，提供持久的项目上下文，可与 Claude Desktop 工作流程无缝集成。

🚀 快速开始

将以下内容复制粘贴到 Claude 或你的 AI 中：

安装 FAF MCP 服务器：npm install -g claude-faf-mcp，然后将以下内容添加到 claude_desktop_config.json 中：{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "claude-faf-mcp"]}}}，并重启 Claude Desktop。

一键替代方案：桌面扩展程序 (.mcpb)

✨ 主要特性

51 个 MCP 工具（100% 独立运行）

• faf_quick - 闪电般快速创建 project.faf（平均 3 毫秒）
• faf_enhance - 智能增强，自动检测
• faf_read - 解析并验证 FAF 文件
• faf_write - 创建/更新 FAF 文件并进行验证
• faf_score - AI 就绪评分引擎
• faf_compress - 智能优化文件大小
• 14 个捆绑命令 - 无需 CLI 依赖，速度提升 16.2 倍

IANA 注册标准

• 官方 MIME 类型：application/vnd.faf+yaml
• 符合 W3C 标准的结构化格式
• 通用 AI 上下文协议
• 跨平台兼容

性能表现

• 比 CLI 版本 快 16.2 倍（直接函数调用与进程生成对比）
• 所有捆绑命令 平均执行时间为 19 毫秒
• 最快 1 毫秒（格式化命令）
• 零内存泄漏

🏁 AI 就绪评分卡

越接近 100%，AI 对你的帮助就越大。

当达到 55% 时，你相当于用一半的蓝图构建项目，与 AI 协作基本靠碰运气。.FAF 通过 project.faf 文件定义并优化 AI 上下文。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏆  FAF AI 就绪评分: 100/100
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 核心智能                    🎯 上下文交付
├─ 项目 DNA            [██████] 100%  ├─ MCP 协议      [██████] 100%
├─ 架构图             [██████] 100%  ├─ 50 个原生工具   [██████] 100%
├─ 领域模型            [██████] 100%  ├─ IANA 格式       [██████] 100%
└─ 版本跟踪            [██████] 100%  └─ 通用上下文 [██████] 100%

🚀 性能                          ⚡ 独立运行
├─ 速度提升 16.2 倍      [██████] 100%  ├─ 零依赖         [██████] 100%
├─ 平均执行时间 19 毫秒  [██████] 100%  ├─ 捆绑引擎       [██████] 100%
├─ 50/50 工具激活      [██████] 100%  ├─ 直接函数调用   [██████] 100%
└─ 零内存泄漏         [██████] 100%  └─ 14 个捆绑命令   [██████] 100%

🏆 状态: 奖杯 - 完美 AI 上下文
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

等级系统

🎯 什么是 FAF？

.FAF 在 MCP 生态系统中的地位：

  模型        上下文          协议
  ─────        ───────          ────────
  大语言模型  →   IANA 格式 →    开放协议
  Claude   →   .faf        →    MCP
  Gemini   →   .faf        →    MCP
  Codex    →   .faf        →    MCP

.FAF 是任何使用 MCP 协议的模型的基础通用层，它提供标准化的上下文，使模型上下文协议适用于所有人。

📚 详细文档

• 更新日志 - 版本历史和发布说明
• 完整文档 - 完整指南
• 常见问题解答 - 常见问题
• 入门指南 - 安装与设置
• MCP 工具参考 - 所有 50 个工具
• 网站 - faf.one
• Discord 社区 - 加入讨论

🏆 为什么选择 FAF？

“AI 时代的 README” — Gemini CLI

持久上下文 - 项目的 DNA 存储在 project.faf 中，任何 AI 或人类都可以读取。

通用格式 - IANA 注册标准，适用于 Claude、Gemini、Codex 等任何大语言模型。

零设置成本 - 一个文件（project.faf）消除了整个团队的 AI 上下文设置工作。

质量工程 - 严格使用 TypeScript，零运行时错误。

📦 生态系统

• FAF 格式规范 - 官方 IANA 规范
• FAF CLI - 命令行工具
• faf-wasm - WASM SDK 用于评分（<5 毫秒）
• Chrome 扩展程序 - 浏览器集成
• faf.one - 官方网站和文档

📄 许可证

本项目采用 MIT 许可证，免费且开源。

为速度和可靠性而构建 ⚡

“如果它不存在，AI 自己都会创造它，这太合理了” — Claude