Gemini Faf MCP

双子座faf mcp

Google Gemini的持久项目上下文。定义一次。到处同步。

FAF定义。MD指示。AI代码。

停止在每次新的双子座会议上重新解释你的项目。双子座的每一次谈话都是冷冰冰的——你每次都会重新陈述你的堆栈、目标和惯例。 .faf 是一个捕获所有内容的结构化文件。此包是允许Gemini读取它的MCP服务器。

  ](https://pypi.org/project/gemini-faf-mcp/)  

前后

Without FAF                           With FAF (.faf at 85%+ Bronze)
─────────────────────────             ─────────────────────────
You: "I'm using FastAPI with...       You: "Add a /users/me endpoint"
      PostgreSQL, pytest, and..."     Gemini: [generates correct code,
Gemini: "Got it. What's the              uses your auth pattern,
        codebase like?"                  matches your test style]
You: "It's a REST API for..."
[5 minutes of re-explaining]
Gemini: [now ready to help]

.faf 在会话开始时读取一次。每个工具调用都落在一个已经知道你的项目的双子座身上。

v2.2.0的新增功能

Mk4锦标赛计分引擎 --所有12个工具现在都使用与Rust编译器和TypeScript CLI相同的评分算法。 faf_score 和 faf_validate 返回插槽级别详细信息(populated, active, total).每种语言的每个FAF工具的分数都匹配。221项测试，41项新的WJTTC锦标赛测试。已删除死代码(sync_faf.py).

v2.2.1 是一个补丁版本——包描述与PyPI、Gemini扩展库和MCP注册表中规范的“Google Gemini持久项目上下文”措辞保持一致。没有代码更改。

______________________________________________________________________

一分钟设置

1.安装

pip install gemini-faf-mcp

2.添加到Gemini CLI

gemini extensions install https://github.com/Wolfe-Jam/gemini-faf-mcp

3.生成项目上下文

在Gemini CLI中：

> /gemini-faf-mcp:setup

您应该看到： Created project.faf — Score: 85% (BRONZE)从这一点开始，这个项目中的每个Gemini会话都会自动读取它。

提示： 85%（青铜色）是双子座停止猜测的最低分数。跑 /gemini-faf-mcp:score 看看缺少什么以及如何达到100%（TROPHY）。

______________________________________________________________________

“一个文件”的优势

A. .faf 该文件是结构化的YAML，可以捕获您的项目DNA。每个AI代理都会阅读一次，并确切地知道你在构建什么。

# project.faf — your project, machine-readable
faf_version: '2.5.0'
project:
  name: my-api
  goal: REST API for user management
  main_language: Python
stack:
  backend: FastAPI
  database: PostgreSQL
  testing: pytest
human_context:
  who: Backend developers
  what: User CRUD with auth
  why: Replace legacy PHP service

结果： 双子座读过一次，就知道你的项目了。没有20分钟的入职培训。没有错误的假设。每次会话都以对齐方式开始。

FAF定义。MD指示。AI代码。

那我的呢 GEMINI.md?

你不能代替它。 .faf 生成 跑吧 faf_gemini 你会得到一个新鲜的 GEMINI.md 将结构化项目数据作为YAML frontmatter进行烘焙——相同 GEMINI.md Gemini CLI已经可以读取，但它是从单一真实来源生成的，而不是手工维护的。

> /gemini-faf-mcp:export
# Generates GEMINI.md from project.faf

.faf 是来源。 GEMINI.md 是其输出之一。同样的逻辑 AGENTS.md （OpenAI Codex）， .cursorrules, CLAUDE.md，和其他——写一次，到处渲染。

______________________________________________________________________

自动检测您的堆栈

faf_auto 扫描项目的清单文件并生成 .faf 具有精确的槽值。无需手动输入。

> Auto-detect my project stack

{
  "detected": {
    "main_language": "Python",
    "package_manager": "pip",
    "build_tool": "setuptools",
    "framework": "FastMCP",
    "api_type": "MCP",
    "database": "BigQuery"
  },
  "score": 100,
  "tier": "TROPHY"
}

它扫描的内容：

优先级规则： pyproject.toml / Cargo.toml / go.mod 优先于 package.json。只设置实际检测到的值，没有硬编码的默认值。

______________________________________________________________________

全部12个工具

创建和检测

验证和评分

读取和转换

导出和互操作

参考

______________________________________________________________________

分数和等级系统

你的 .faf 文件的完整性评分——有多少插槽被实际值填充。

Auto-detect my project and fill in the stack Score my .faf and show what's missing Export GEMINI.md for this project Show me a 100% example for an MCP server What is FAF and how does it work? Read my project.faf and summarize the stack Validate my .faf and fix the warnings

______________________________________________________________________

## 建筑

gemini-faf-mcp v2.2.1 ├── server.py → FastMCP MCP server (12 tools, Mk4 scoring) ├── main.py → Cloud Run REST API (GET/POST/PUT) ├── models.py → 15 project type examples └── src/gemini_faf_mcp/ → Python SDK (FAFClient, parser)

MCP服务器委托 `faf-python-sdk` 用于解析、验证和Mk4评分 `faf_auto` 是Python原生的——没有外部CLI依赖关系。

______________________________________________________________________

## 测试

pip install -e ".[dev]" python -m pytest tests/ -v

221项测试通过了9个WJTTC级别（125个MCP服务器+55个云功能+41个Mk4 WJTTC锦标赛）。锦标赛级测试覆盖率-- [WJTTC认证](https://github.com/Wolfe-Jam/WJTTC).

______________________________________________________________________

## FAF生态系统

一种格式，每个AI平台。

|包|平台|注册表|
|---------|----------|----------|
| [克劳德·法夫·麦克普](https://npmjs.com/package/claude-faf-mcp) |人类学| npm+MCP#2759|
| **双子座faf mcp** | **谷歌** | **PyPI** |
| [grok faf mcp](https://npmjs.com/package/grok-faf-mcp) |xAI | npm|
| [铁锈faf-mcp](https://crates.io/crates/rust-faf-mcp) |铁锈| crates.io|
| [faf-cli](https://npmjs.com/package/faf-cli) |通用| npm|

______________________________________________________________________

## 开发包

在Python中直接使用FAF而不使用MCP：

from gemini_faf_mcp import FAFClient, parse_faf, validate_faf, find_faf_file

Parse and validate locally

data = parse_faf("project.faf") result = validate_faf(data) print(f"Score: {result['score']}%, Tier: {result['tier']}")

Find .faf files automatically

faf_path = find_faf_file(".")

Or use the Cloud Run endpoint

client = FAFClient() dna = client.get_project_dna()

______________________________________________________________________

## 云运行REST API

徽章、多代理上下文代理和语音到FAF突变的实时端点。

https://faf-source-of-truth-631316210911.us-east1.run.app

通过以下方式支持代理优化响应（Gemini、Claude、Grok、Jules、Codex/Copilot/Cursor） `X-FAF-Agent` 头球通过Gemini Live的PUT端点进行语音突变。通过Cloud Build on push自动部署 `main`.

______________________________________________________________________

如果 `gemini-faf-mcp` 已经很有用了，考虑在回购中担任主角——它可以帮助其他人找到它。

______________________________________________________________________

## 链接

- [FAF规范](https://faf.one)
- [IANA注册](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml)
- [faf python sdk](https://pypi.org/project/faf-python-sdk/)
- [faf-cli](https://npmjs.com/package/faf-cli)
- [更新日志](./CHANGELOG.md)

## 许可证

麻省理工学院

______________________________________________________________________

建造于 [@枸杞果酱](https://x.com/wolfe_jam) | [wolfejam.dev](https://wolfejam.dev)

______________________________________________________________________

### 获取CLI

> **faf-cli** --最初的AI上下文CLI。这是每个建筑商的必备品。

npx faf-cli auto