FAF MCP server for Gemini. 12 tools. Project DNA via IANA-registered .faf format. Python/FastMCP.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"io-github-wolfe-jam-gemini-faf-mcp": {
"args": [
"-y",
"faf-cli"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Persistent Project Context for Google Gemini. Define once. Sync everywhere.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'faf-cli' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked faf-cli against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in developer-tools
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors
Copy/paste detector for programming source code, supports 223 formats. AI-ready with token-efficient reporter, skill and MCP server.
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
MCP Security Weekly
Get CVE alerts and security updates for io.github.Wolfe-Jam/gemini-faf-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
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.
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_gemininon-destructive (inject a structured.fafblock, preserve your Markdown below). v2.4.2 — The Confinement Edition confined every callerpathargument (security). v2.4.0 — The Chameleon Edition auto-selects its transport: stdio locally, Streamable HTTP on Cloud Run. 12 tools, zero config.
uvx gemini-faf-mcp # zero-install run via uvx (fetched from PyPI)
# or: pip3 install gemini-faf-mcp
gemini extensions install https://github.com/Wolfe-Jam/gemini-faf-mcp
In your Gemini CLI:
> /faf:setup
You should see: Created project.faf — Score: 85% (BRONZE). From this point, every Gemini session in this project reads it automatically.
Tip: A score of 85% (BRONZE) is the minimum where Gemini stops guessing. Run
/faf:scoreto see what's missing and how to push to 100% (TROPHY).
A .faf file is structured YAML that captures your project DNA. Every AI agent reads it once and knows exactly what you're building.
# project.faf — your project, machine-readable
faf_version: '2.5.0'
project:
name: my-api
goal: REST API for user management
main_language: Python
... [View full README on GitHub](https://github.com/Wolfe-Jam/gemini-faf-mcp#readme)