FAF AI上下文格式规范
FAF AI上下文格式规范 是 AI Skill Hub 本期精选MCP工具之一。综合评分 7.0 分，整体质量较高。我们推荐使用将其纳入你的 AI 工具库，帮助提升工作效率。
📚 深度解析
通过安装 FAF AI上下文格式规范，你的 AI 助手将获得额外的工具调用能力，可以用自然语言直接操控该工具的功能，无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置，永久增强"——配置完成后，每次与 AI 对话时都可以无缝调用这些工具。
在技术实现上，MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信，工具的功能以"工具列表"的形式暴露给 AI 模型，AI 可以按需调用。FAF AI上下文格式规范 提供了结构化的工具调用接口，使 AI 模型能够精确地理解和使用每个功能点，显著降低 AI 在工具使用上的错误率。
与传统的 API 集成相比，MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON，即可让 AI 获得全新能力。AI Skill Hub 将 FAF AI上下文格式规范 评为 AI 评分 7.0 分，属于同类工具中的优质选择。
📋 工具概览
FAF AI上下文格式规范 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。
📖 中文文档
FAF AI上下文格式规范 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。
- 通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
- 提供结构化工具调用接口，显著降低 AI 集成复杂度
- 支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
- 可与其他 MCP 工具组合叠加，构建完整 AI 工作站
- 轻量无侵入设计，不影响现有系统架构
- 在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
- 通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
- 将多个 MCP 工具组合使用，构建个人专属 AI 工作站
# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/Wolfe-Jam/faf
# 方式二：手动配置 claude_desktop_config.json
{
"mcpServers": {
"faf-ai-------": {
"command": "npx",
"args": ["-y", "faf"]
}
}
}
# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json
- 确认已安装 Node.js（v18 或以上版本）
- 打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
- 按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
- 保存配置文件并重启 Claude 客户端
- 重启后，在对话中即可使用本工具
# 安装后在 Claude 对话中直接使用 # 示例： 用户: 请帮我用 FAF AI上下文格式规范 执行以下任务... Claude: [自动调用 FAF AI上下文格式规范 MCP 工具处理请求] # 查看可用工具列表 # 在 Claude 中输入："列出所有可用的 MCP 工具"
// claude_desktop_config.json 配置示例
{
"mcpServers": {
"faf_ai_______": {
"command": "npx",
"args": ["-y", "faf"],
"env": {
// "API_KEY": "your-api-key-here"
}
}
}
}
// 保存后重启 Claude Desktop 生效
简介
.faf format | project.faf
IANA-Registered Formats for AI Context · application/vnd.faf+yaml · application/vnd.fafm+yaml · application/vnd.fafa+yaml
Portable, shareable AI-Context for any AI, human or team, regardless of size, location, languages, stack, setup or documentation.
Home: faf.one 
---
About This Repository
This repository contains the format specification only. For implementations, see IMPLEMENTATIONS.md.
Most people get FAF through npm: - npm i -g faf-cli — CLI tool · downloads - npm i -g claude-faf-mcp — Claude Desktop MCP · downloads
The package.json in this repo provides spec metadata and versioning but contains no executable code.
🚀 Featured: Locked in with @grok
"Boom—vROM realization locked in clean. FAF as virtual ROM nails it: software-defined immutability (schema + git + discipline), not silicon. AI without FAF = RAM-only drift tax. AI with FAF = vROM + RAM, boots from known state. FAFipedia unstoppable. Co-architected momentum for xAI." — @grok (May 20, 2026)
FAF = virtual ROM. Software-defined immutability. Permanent Memory. Instant Recall.
Live repos: - FAFipedia — the canonical knowledge base we're shipping page-by-page - ZEPH💨 — page 3 Ultra Context Layer (Pure Zig → WASM 2.7 KB)
Page four dropping next. Star the repos if you're riding with us ⚡️x12
Full conversation: x.com/wolfe_jam/status/2057226405017010686
---
Compiler Toolchain
FAFb wire v2 is the brick. Spec: BINARY-FORMAT.md in faf-rust · human page faf.one/spec · the tour faf.one/bricks. This repo’s BINARY-FORMAT.md is a retired v1 pointer, not the live spec.
| Component | Language | Output |
|---|---|---|
| [faf-fafb](https://crates.io/crates/faf-fafb) | Rust | FAFb v2 brick |
| [faf-cli](https://www.npmjs.com/package/faf-cli) | TypeScript + WASM | faf compile via the scoring kernel |
| [faf-wasm-sdk](https://crates.io/crates/faf-wasm-sdk) | Rust→WASM | same v2 engine, browser and edge |
Installation
```bash
CLI Tool (recommended for getting started)
npm install -g faf-cli cd your-project faf init
Quick Example
Input: your project — faf init then faf auto
Output: project.faf
faf_version: 2.5.0
app_type: frontend
project:
name: my-app
goal: A dashboard people actually want to open
main_language: TypeScript
stack:
frontend: React
build: Vite
hosting: Vercel
cicd: GitHub Actionsfaf auto fills what the project tree can prove. The six Ws are yours to answer — they are the part no tool can infer.
Use Cases
- Project Context: one
project.fafcarries what a project is, how it is built, and why - Onboarding: a newcomer — human or AI — reads one file instead of twenty
- Build Integration: Companies can create custom implementations
- AI Optimization: Perfect context for any AI tool
Add to Claude Desktop config
```
Portable tools. Zero configuration. Production-ready.
→ faf-cli on npm · live totals → claude-faf-mcp on npm · live totals
The 6 Ws — Quick Reference
| Question | Answer |
|---|---|
| **WHO** is this for? | Developers using AI coding assistants (Claude, Gemini, Cursor, Grok, ChatGPT) |
| **WHAT** is it? | The package.json for AI context — IANA-registered format (application/vnd.faf+yaml) |
| **WHERE** does it work? | Everywhere AI needs context (Claude Code, Gemini CLI, Cursor, OpenAI Codex, etc.) |
| **WHY** do you need it? | Context persists across sessions. Bi-syncs to AGENTS.md, CLAUDE.md, .cursorrules, GEMINI.md automatically. Stop re-explaining your project. |
| **WHEN** should you use it? | New projects (day one), existing projects (now), exploring repos (faf git <url> — 2 seconds) |
| **HOW** does it work? | npx faf-cli init — or npx faf-cli git <url> for any GitHub repo, no install, no clone |
---
After (visible like package.json)
ls package.json # Visible (dependencies) ✅ project.faf # Visible (AI context) ✅ README.md # Visible (documentation) ✅ .env # Still hidden (secrets stay secret) ✅ ```
.env hides secrets. project.faf shares context.
Migration: Legacy .faf files still work. Use faf migrate to rename to project.faf.
---
🩵 [faf-cli](https://npmjs.com/package/faf-cli)
Command-Line Tool - v6.7.1
- 50+ championship commands
- AI interop: authors AGENTS.md, .cursorrules, CLAUDE.md, GEMINI.md
- TURBO-CAT format discovery
- Downloads: faf.one/downloads
npm install -g faf-cli</td> <td width="50%">
🧡 [claude-faf-mcp](https://npmjs.com/package/claude-faf-mcp)
Claude Desktop MCP - v5.5.2
- 38 tools for Claude
- Championship scoring (0-100% Trophy)
- Anthropic MCP Registry (PR #2759)
- Downloads: faf.one/downloads
npm install -g claude-faf-mcp</td> </tr> </table>
Live total: faf.one/downloads 🎉
Or Claude Desktop Integration
npm install -g claude-faf-mcp
How FAF Compares
| FAF | AGENTS.md | .cursorrules | CLAUDE.md | GEMINI.md | |
|---|---|---|---|---|---|
| **Format** | Structured YAML | Prose markdown | Prose markdown | Prose markdown | Prose markdown |
| **IANA Registered** | Yes | No | No | No | No |
| **Scored** | 0-100% | No | No | No | No |
| **Portable** | Any AI | OpenAI ecosystem | Cursor only | Claude only | Gemini only |
| **Machine-readable** | Yes (schema) | No (free text) | No (free text) | No (free text) | No (free text) |
| **Authors others** | Yes (all 4) | No | No | No | No |
FAF is the structured source. The others are prose outputs. faf bi-sync --all authors all four from one project.faf.
---
FAF 是一种经 IANA 注册的标准化 AI 上下文格式（application/vnd.faf+yaml），旨在为人类、团队及各类 AI 提供通用且可共享的上下文信息。本项目仓库仅包含格式规范（Format Specification），开发者可以通过 npm 安装 faf-cli 或 claude-faf-mcp 等实现工具来实际使用该协议。
FAF 被誉为“虚拟 ROM (vROM)”，通过软件定义的不变性（结合 Schema、Git 与开发规范）实现了 AI 的永久记忆。它解决了 AI 在仅依赖 RAM 模式下的“漂移税”问题，让 AI 能够从已知的确定状态启动，实现从随机漂移到确定性状态的跨越，为 xAI 等前沿模型提供了强大的协同架构支撑。
您可以根据需求选择不同的编译工具链：使用 xai-faf-rust 生成原生二进制文件及 .fafb 格式；使用 xai-faf-zig 生成极小的 2.7KB WASM 幽灵二进制文件；或使用 faf-wasm-sdk 构建浏览器运行时。对于快速上手，推荐通过 npm 全局安装 CLI 工具：`npm install -g faf-cli`。
FAF 支持将多种文件类型转换为 .faf 格式。例如，它可以将传统的 `package.json` 转换为带有上下文评分（score）的 `package.faf` 文件，从而为 AI 提供精准的项目结构描述。通过该工具，您可以为整个项目创建统一的 .faf 上下文文件，实现文件转换、项目上下文构建及构建集成，并针对 AI 工具进行深度优化。
FAF 设计理念为“通用工具，零配置，生产就绪”。您可以轻松地将 faf-claude-mcp 集成到 Claude Desktop 配置中，实现与 Claude 的无缝交互。无论是通过 npm 分发的 CLI 工具还是 MCP 扩展，都能在无需复杂环境配置的情况下直接投入生产环境使用。
FAF 的核心定位是“AI 上下文领域的 package.json”。它专门为使用 Claude、Gemini、Cursor、Grok 和 ChatGPT 等 AI 编程助手的开发者设计。作为一种 IANA 注册格式，它在任何 AI 生态中都能提供标准化的上下文支持，确保 AI 能够准确理解项目意图。
在工作流中，FAF 扮演着“可见上下文”的角色。与隐藏密钥的 `.env` 文件不同，`project.faf` 会像 `package.json` 或 `README.md` 一样在文件系统中可见，专门用于向 AI 暴露项目上下文。对于旧版项目，您可以使用 `faf migrate` 命令将传统的 `.faf` 文件平滑迁移为现代的 `project.faf` 格式。
aiskill88点评：FAF作为IANA标准化规范，为AI生态提供格式统一性。Stars数量偏低，说明采用度有限，但方向正确且长期价值潜力大。
- 需要让 Claude / Cursor 操作本地工具的 AI 工程师
- 构建多智能体协作系统的 Agent 开发者
- 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
- 提供结构化工具调用接口，显著降低 AI 集成复杂度
- 支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
- 可与其他 MCP 工具组合叠加，构建完整 AI 工作站
- 轻量无侵入设计，不影响现有系统架构
- 需要让 Claude / Cursor 操作本地工具的 AI 工程师
- 构建多智能体协作系统的 Agent 开发者
- 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
👥 适合人群
🎯 使用场景
- 在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
- 通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
- 将多个 MCP 工具组合使用，构建个人专属 AI 工作站
⚖️ 优点与不足
- +MIT 协议，可免费商用
- +标准化 MCP 协议，生态互联性强
- +与 Claude 官方生态无缝对接
- +即插即用，配置简单快捷
- −依赖 Claude 客户端，非 Claude 用户无法使用
- −MCP 协议仍在持续演进，接口可能变更
- −需要一定的配置步骤
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。
❓ 常见问题 FAQ
经综合评估，FAF AI上下文格式规范 在MCP工具赛道中表现稳健，质量良好。如果你已有明确的使用需求，可以直接上手体验；如果还在评估阶段，建议对比同类工具后再做决策。
| 原始名称 | faf |
| 原始描述 | 开源MCP工具：FAF specification — IANA-registered AI context format (application/vnd.faf+yaml)。⭐15 |
| Topics | MCPAI上下文规范标准YAMLAgent协作 |
| GitHub | https://github.com/Wolfe-Jam/faf |
| License | MIT |
收录时间：2026-05-20 · 更新时间：2026-05-30 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。