Gemini FAF
About
Persistent Project Context for Google Gemini — IANA-registered .faf format · MCP server + Cloud Run REST API
Details
- Author
- Wolfe-Jam
- GitHub stars
- 2
- Downloads
- 276
- Categories
- AI
Jump to
- FAF Specification
- IANA Registration
- faf-python-sdk
- faf-cli
- Changelog
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Gemini FAFCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
The README includes setup instructions such as uvx gemini-faf-mcp # zero-install run via uvx (fetched from PyPI).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"gemini faf": {
"gemini-faf-mcp": {
"command": "uvx",
"args": [
"gemini-faf-mcp",
"#",
"zero-install",
"run",
"via",
"uvx",
"(fetched",
"from",
"PyPI)"
]
}
}
}
}McpServers
{
"gemini-faf-mcp": {
"command": "uvx",
"args": [
"gemini-faf-mcp",
"#",
"zero-install",
"run",
"via",
"uvx",
"(fetched",
"from",
"PyPI)"
]
}
}gemini-faf-mcp — The Dart Edition
Persistent Project Context for Google Gemini. Define once. Sync everywhere.
FAF defines. MD instructs. AI codes.
Stop re-explaining your project to every new Gemini session. Every Gemini conversation starts cold — you re-state your stack, your goals, your conventions every single time. .faf is one structured file that captures all of it. This package is the MCP server that lets Gemini read it.
<!-- mcp-name: one.faf/gemini-faf-mcp -->
Before and after
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 is read once at session start. Every tool call lands on a Gemini that already knows your project.
What's New in v2.5.0 — The Dart Edition
> v2.5.1 — one.faf namespace migration: gemini joins the fleet on one.faf/gemini-faf-mcp (registry publish now DNS-authenticated). No tool or behaviour changes.
gemini-faf-mcp now understands Dart and Flutter projects.
Detects Dart/Flutter from a pubspec.yaml — Flutter app vs package · Dart MCP / backend / CLI / library — by composing faf-python-sdk's detector, the shared engine, not a fork. Zero-Config, 12 exact tools.
> v2.4.3 made faf_agents / faf_gemini non-destructive (inject a structured .faf block, preserve your Markdown below). v2.4.2 — The Confinement Edition confined every caller path argument (security). v2.4.0 — The Chameleon Edition auto-selects its transport: stdio locally, Streamable HTTP on Cloud Run. 12 tools, zero config.
---
One-Minute Setup
1. Install
```bash
uvx gemini-faf-mcp # zero-install run via uvx (fetched from PyPI)
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
