项目简介

FAF MCP服务器是一个基于Model Context Protocol (MCP) 构建的通用AI上下文服务后端，实现了IANA注册的Foundational AI-context Format (.faf) 标准。它通过JSON-RPC协议与客户端通信，提供资源管理、工具执行和Prompt模板渲染等核心MCP功能。

主要功能

项目管理: 提供faf_init、faf_score等工具，评估项目的AI可读性
文件操作: 支持本地文件的读取、写入、列表等操作
上下文同步: 实现.faf文件与CLAUDE.md之间的双向同步
智能检测: 自动识别项目类型、技术栈和框架
安全防护: 内置路径遍历保护、输入清理和资源限制机制
多传输协议: 支持Stdio、SSE和WebSocket等多种通信方式
信任系统: 提供信任度评估和信心保证机制
性能优化: 响应时间目标低于50ms，内存效率高
工具可见性: 56个工具分为21个核心工具和35个高级工具，可根据配置过滤显示

安装步骤

npm install -g faf-mcp

服务器配置

在Claude Desktop等MCP客户端中添加以下配置：

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

基本使用方法

安装并配置后，重启Claude Desktop即可使用FAF工具。可以通过调用'faf_score()'等命令测试服务器功能。

技术特性

完全使用TypeScript原生实现，无需shell执行
支持桌面原生模式，无需CLI依赖即可运行核心功能
提供3-3-1显示格式，确保内容在客户端中正确渲染

关键词