{"id":45721591,"url":"https://github.com/Wolfe-Jam/faf-mcp","last_synced_at":"2026-03-10T13:01:12.875Z","repository":{"id":324121661,"uuid":"1056798446","full_name":"Wolfe-Jam/faf-mcp","owner":"Wolfe-Jam","description":"Universal MCP server for .faf — Cursor, Windsurf, VS Code, Cline, and all MCP-compatible platforms","archived":false,"fork":false,"pushed_at":"2026-03-07T19:28:51.000Z","size":1939,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-07T22:19:46.547Z","etag":null,"topics":["agents-md","ai","ai-context","claude","cline","cursor","developer-tools","faf","gemini","grok","mcp","mcp-server","model-context-protocol","nodejs","npm","project-dna","typescript","vscode","warp","windsurf"],"latest_commit_sha":null,"homepage":"https://faf.one","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Wolfe-Jam.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"wolfejam","ko_fi":"wolfejam","custom":["https://faf.one/sponsors"]}},"created_at":"2025-09-14T20:27:52.000Z","updated_at":"2026-03-07T19:28:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Wolfe-Jam/faf-mcp","commit_stats":null,"previous_names":["wolfe-jam/faf-mcp"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/Wolfe-Jam/faf-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wolfe-Jam%2Ffaf-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wolfe-Jam%2Ffaf-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wolfe-Jam%2Ffaf-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wolfe-Jam%2Ffaf-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Wolfe-Jam","download_url":"https://codeload.github.com/Wolfe-Jam/faf-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wolfe-Jam%2Ffaf-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30334408,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T12:41:07.687Z","status":"ssl_error","status_checked_at":"2026-03-10T12:41:06.728Z","response_time":106,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents-md","ai","ai-context","claude","cline","cursor","developer-tools","faf","gemini","grok","mcp","mcp-server","model-context-protocol","nodejs","npm","project-dna","typescript","vscode","warp","windsurf"],"created_at":"2026-02-25T06:00:30.314Z","updated_at":"2026-03-10T13:01:12.864Z","avatar_url":"https://github.com/Wolfe-Jam.png","language":"TypeScript","funding_links":["https://github.com/sponsors/wolfejam","https://ko-fi.com/wolfejam","https://faf.one/sponsors"],"categories":["CI/CD \u0026 DevOps Pipelines","📦 Other"],"sub_categories":["🤖 Coding Agents"],"readme":"\u003cdiv style=\"display: flex; align-items: center; gap: 12px;\"\u003e\n  \u003cimg src=\"https://www.faf.one/orange-smiley.svg\" alt=\"FAF\" width=\"40\" /\u003e\n  \u003cdiv\u003e\n    \u003ch1 style=\"margin: 0; color: #FF8C00;\"\u003efaf-mcp\u003c/h1\u003e\n    \u003cp style=\"margin: 4px 0 0 0;\"\u003e\u003cstrong\u003ev2.0.0 — The Interop MCP for Context\u003c/strong\u003e\u003c/p\u003e\n  \u003c/div\u003e\n\u003c/div\u003e\n\nThe MCP you didn't realise you needed, or wanted but didn't know who to ask, is here. Building on 36,000+ downloads across Claude and now Gemini, we bring you faf-mcp v2.0.0 to cure your syncing pain and fuel your chosen AI with optimized context, on-demand.\n\n**The only IANA-Registered Format for AI Context** · `application/vnd.faf+yaml`\n\n[![CI](https://github.com/Wolfe-Jam/faf-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Wolfe-Jam/faf-mcp/actions/workflows/ci.yml)\n[![NPM Downloads](https://img.shields.io/npm/dt/faf-mcp?label=total%20downloads\u0026color=00CCFF)](https://www.npmjs.com/package/faf-mcp)\n[![npm version](https://img.shields.io/npm/v/faf-mcp?color=00CCFF)](https://www.npmjs.com/package/faf-mcp)\n[![Website](https://img.shields.io/badge/Website-faf.one-orange)](https://faf.one)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![project.faf](https://img.shields.io/badge/project.faf-inside-00D4D4)](https://github.com/Wolfe-Jam/faf)\n[![Deploy](https://img.shields.io/badge/Deploy-Vercel-black)](https://vercel.com/new?repository-url=https://github.com/Wolfe-Jam/faf-mcp)\n\n---\n\n## Define once. Sync everywhere.\n\nYou maintain `.cursorrules`. Your teammate uses `AGENTS.md`. Someone on the team just switched to Gemini. Every AI tool wants its own context file — and they all say the same thing in different formats.\n\n**faf-mcp is the dedicated MCP server for Cursor, Windsurf, Cline, VS Code, and every non-Claude platform.** One `.faf` file in your repo, synced to every format your team needs.\n\n```\n                      project.faf\n                           │\n          ┌────────┬───────┴───────┬────────────┐\n          ▼        ▼               ▼            ▼\n      CLAUDE.md  AGENTS.md  .cursorrules  GEMINI.md\n      (Claude)   (Codex)      (Cursor)    (Gemini)\n```\n\n### Quick Start\n\n```bash\nnpx faf-mcp\n```\n\nAdd to your MCP config:\n\n```json\n{\"mcpServers\": {\"faf\": {\"command\": \"npx\", \"args\": [\"-y\", \"faf-mcp\"]}}}\n```\n\n| Platform | Config File |\n|----------|-------------|\n| **Cursor** | `~/.cursor/mcp.json` |\n| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` |\n| **Cline** | Cline MCP settings |\n| **VS Code** | MCP extension config |\n| **Claude Desktop** | Use [claude-faf-mcp](https://github.com/Wolfe-Jam/claude-faf-mcp) |\n\n---\n\n## Three Ways to Deploy\n\n| Door | Method | Best For |\n|------|--------|----------|\n| **Hosted** | [mcpaas.live](https://mcpaas.live) | Zero-install, point any MCP client to the URL |\n| **Self-Deploy** | [Deploy to Vercel](https://vercel.com/new?repository-url=https://github.com/Wolfe-Jam/faf-mcp) | Your own instance, full control |\n| **Local** | `npx faf-mcp` | IDE integration via stdio transport |\n\n### Hosted (mcpaas.live)\n\nPoint your MCP client to `https://mcpaas.live/sse` — no install, no config, no maintenance. Served from 300+ Cloudflare edges with sub-ms cold starts via 2.7KB Zig-WASM engine.\n\n### Self-Deploy (Vercel)\n\nDeploy your own MCP server on Vercel in one click. Once deployed, your server exposes:\n- `/health` — Health check\n- `/info` — Server metadata + tool list\n- `/sse` — MCP Server-Sent Events transport\n\n### Local (npm)\n\n```bash\nnpx faf-mcp\n```\n\n---\n\n## 🔄 Interop Tools\n\n| Tool | Platform | Action |\n|------|----------|--------|\n| `faf_agents` | OpenAI Codex | Import/export/sync AGENTS.md |\n| `faf_cursor` | Cursor IDE | Import/export/sync .cursorrules |\n| `faf_gemini` | Google Gemini | Import/export/sync GEMINI.md |\n| `faf_conductor` | Conductor | Import/export directory structure |\n| `faf_git` | GitHub | Generate .faf from any repo URL |\n\n```bash\n# Sync to all formats at once\nfaf bi-sync --all\n\n# Generate .faf from any GitHub repo\nfaf_git { url: \"https://github.com/facebook/react\" }\n```\n\n**61 tools** (25 core + 36 advanced) · **309 tests** (9 suites) · **7 bundled parsers**\n\n---\n\n## ☁️ Cloud Sync\n\nShare your FAF context globally via [mcpaas.live](https://mcpaas.live):\n\n| Tool | Purpose |\n|------|---------|\n| `faf_cloud_publish` | Upload to cloud, get shareable URL |\n| `faf_cloud_fetch` | Pull context from cloud |\n| `faf_cloud_list` | List available souls |\n| `faf_cloud_search` | Search across souls |\n| `faf_cloud_share` | Generate share links |\n\n**Example Workflow:**\n```bash\n# Upload your project.faf\nfaf_cloud_publish { soul_name: \"my-project\" }\n→ https://mcpaas.live/souls/my-project\n\n# Anyone can fetch it\nfaf_cloud_fetch { soul_name: \"my-project\" }\n→ Context merged into local project.faf\n```\n\n**Zero-install sharing** - Recipients need no MCP setup. Served from 300+ Cloudflare edges with \u003c1ms cold starts via 2.7KB Zig-WASM engine.\n\n---\n\n## 🔄 Eternal Bi-Sync\n\nYour `.faf` file and your platform context files stay synchronized in milliseconds.\n\n```\nproject.faf  ←── 8ms ──→  .cursorrules / AGENTS.md / CLAUDE.md / GEMINI.md\n                    Single source of truth\n```\n\n- Update either side → both stay aligned\n- `--all` flag syncs to all four formats at once\n- Zero manual maintenance\n- Works across teams, branches, sessions\n\nAI assistants forget. They drift. Every new session, AI starts guessing again. Bi-sync means **context never goes stale**.\n\n---\n\n## Tier System: From Blind to Optimized\n\n| Tier | Score | Status |\n|------|-------|--------|\n| 🏆 **Trophy** | 100% | **AI Optimized** — Gold Code |\n| 🥇 **Gold** | 99%+ | Near-perfect context |\n| 🥈 **Silver** | 95%+ | Excellent |\n| 🥉 **Bronze** | 85%+ | Production ready |\n| 🟢 **Green** | 70%+ | Solid foundation |\n| 🟡 **Yellow** | 55%+ | AI flipping coins |\n| 🔴 **Red** | \u003c55% | AI working blind |\n| 🤍 **White** | 0% | No context at all |\n\n**At 55%, AI is guessing half the time.** At 100%, AI is optimized.\n\n---\n\n## 💬 use\u003efaf | Prompt Pattern\n\n**Start every prompt with \"Use FAF\"** to invoke MCP tools:\n\n```\nUse FAF to initialize my project\nUse FAF to score my AI-readiness\nUse FAF to sync my context\nUse FAF to enhance my project\n```\n\nWorks on all platforms — stops web search, forces tool usage.\n\n---\n\n## 🛠️ 25 Core MCP Tools\n\n| Tool | Purpose |\n|------|---------|\n| `faf_init` | Initialize project.faf |\n| `faf_score` | Check AI-readiness (0-100%) |\n| `faf_sync` | Sync context across platforms |\n| `faf_bi_sync` | Bi-directional .faf ↔ CLAUDE.md |\n| `faf_enhance` | Intelligent enhancement |\n| `faf_read` | Parse and validate FAF files |\n| `faf_write` | Create/update FAF with validation |\n| **🔄 Interop Tools** | |\n| `faf_agents` | Import/export/sync AGENTS.md |\n| `faf_cursor` | Import/export/sync .cursorrules |\n| `faf_gemini` | Import/export/sync GEMINI.md |\n| `faf_conductor` | Import/export directory structure |\n| `faf_git` | Generate .faf from GitHub repo URL |\n| **☁️ Cloud Tools** | |\n| `faf_cloud_publish` | Upload to mcpaas.live |\n| `faf_cloud_fetch` | Pull from cloud |\n| `faf_cloud_list` | List souls |\n| `faf_cloud_search` | Search souls |\n| `faf_cloud_share` | Generate share links |\n\n**Plus 36 advanced tools and CLI fallback** (via faf-cli v5.0.1):\n- `faf readme` - Extract 6 Ws from README (+25-35% boost)\n- `faf human-add` - Non-interactive YAML merge (6Ws Builder)\n- `faf git` - GitHub repo analysis without cloning\n- And 40+ more commands...\n\n---\n\n## 📦 Ecosystem\n\n- **[claude-faf-mcp](https://npmjs.com/package/claude-faf-mcp)** — Claude Desktop (33 tools)\n- **[faf-cli](https://npmjs.com/package/faf-cli)** — Terminal CLI\n- **[faf-wasm](https://www.npmjs.com/package/faf-wasm)** — WASM SDK (\u003c5ms scoring)\n- **[faf.one](https://faf.one)** — Official website\n\n---\n\n## 📄 License\n\nMIT License — Free and open source\n\n---\n\n**Zero drift. Eternal sync. AI optimized.** 🏆\n\n*\"It's so logical if it didn't exist, AI would have built it itself\" — Claude*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWolfe-Jam%2Ffaf-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FWolfe-Jam%2Ffaf-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWolfe-Jam%2Ffaf-mcp/lists"}