claude-faf-mcp

claude-faf-mcp

ホーム: faf.one/mcp サイト: claude.faf.one

メモリーでプロジェクトのコンテキストを継続的に保持し、自動でループします。 ワンクリックでセットアップ。30秒。🐘 Nellyは決して忘れません。

FAFが定義し、MDが指示し、AIがコードを書きます。

⭐ ブックマークしてくれるので、ほかの開発者にも見つけてもらいやすくなります。

FAF Context Ingestion Contractのv0.2準拠リーダーです。

🐘 tri-sync | .faf → MEMORY.md（faf_tri_sync）、および .faf → CLAUDE.md（faf_sync）。

⚡ fafプロンプト — ホストのプロンプト一覧から選択してください（Claude Codeでは/mcp__<server name>__fafと表示されます）。プロジェクトを評価し、リポジトリから補える情報を入力し、あなたにしか答えられないことだけを尋ね、検証して同期します。

7.0.0はメジャーリリースです。スコアが変わることがあります。 claude-faf-mcpは現在、faf-cli 8の常時33項目エンジンでスコアを算出します。12個のエンタープライズ向けslotignoredマーカーがない.fafでは、それらを空として数えます（入力済みが21項目の場合は64%）。faf_autoを実行すると、マーカーが書き込まれます。npx設定とSessionStartフックではバージョンが固定されていないため、npx -y claude-faf-mcpを実行するインストール環境は、次回の起動時に7.xへ更新されます。すべての変更はCHANGELOGに記載されています。

Claude向けコンテキスト: faf-cliは、スコアが算出されたこのリポジトリのproject.fafからCLAUDE.mdを書き出します。ここではfaf_sync、faf-cliではfaf syncを使います。Claude Code向けFAF-CLI 👀をご覧ください。

faf-cliを組み合わせて使用します（バージョンはpackage.jsonで固定されています）。検出、スコア算出、レンダリング、すべての書き込み処理はfaf-cli独自の関数であり、依存関係として読み込まれます。claude-faf-mcpはそれらをフォークせず、PATH上で見つかったfafを実行することもありません。

MCPツールは基本14個（FAF_TOOLS=allでは30個）です。IANA登録済み形式（application/vnd.faf+yaml · application/vnd.fafm+yaml）。

---

v7.1.0 の新機能 — Instructions Edition

claude-faf-mcp が、ツール同士の連携方法を Claude に伝えるようになりました。initialize 時のサーバー指示（637 文字）に加え、skills リポジトリを見分ける faf-cli 8.5.0 を搭載しています。

• サーバー指示。 Claude が接続すると、サーバーはツール同士の連携方法を5つの短い行で伝えます。プロジェクトは一度に1つ、まず project.faf を読む、ユーザーに人間が答える項目を尋ねる、project.faf を情報源とする、求められた場合にのみ記憶する、という内容です。
• faf-cli 8.5.0 を搭載。 faf_init と faf_auto が skills リポジトリを検出します。SKILL.md フォルダーがあれば skills（10スロット）になり、Claude Code プラグインのマニフェストがあれば skills-plugin（14スロット）になります。
• --version と --help は、サーバーを起動せずに表示して終了します。
• 3つのアドバイザリーに対応しました： MCP SDK、zod、hono。

Always33 Edition（7.0）

1つのエンジン、1つの数値：claude-faf-mcp 7 は faf-cli 8 の always-33 カーネルでスコアを算出します。faf-cli と faf-kernel が出すスコアと同じです。

• always-33 エンジン。 すべてのツールが faf-cli 8.0.0 でスコアを算出します。Mk4 の全33スロットを、1つの Rust カーネルで処理します。ライブで確認した結果は、faf-python-sdk が56、mcp-context-card が56、faf-cli が✪ 100で、faf-cli とリファレンススコアラーの結果と同じです。
• 21のスロットと、表示される12のエンタープライズスロット。 エンタープライズスロット（infra、app、ops）は、アプリの種類で使用しない場合、slotignored としてマークされます。faf_score は全33スロットを基準にスコアを算出し、slotignored のスロットは分母から除外されます。
• アップグレード： 12個のマーカーがない .faf は、今後33スロットを基準にスコアが算出されます。faf_auto を実行してください。マーカーが書き込まれ、スコアが元に戻ります（実際の v7 時代のファイルでは、56% → ✪ 100%）。

---

v6.0.0 — Earned Badge Edition

獲得したバッジだけを表示し、未獲得のものは表示しません。claude-faf-mcp 6.0 は faf-cli を組み合わせ、書き込んだものだけを変更します。すべてのツールが事実を伝えます。スコアは1つ、事実はリポジトリから、PATH の情報は使いません。

• faf-cli 7.13 を組み合わせています。 検出、スコア算出、レンダリング、すべての書き込み処理は faf-cli 自身の関数です。claude-faf-mcp は PATH 上で見つかった faf を実行しません。
• 書き込んだものだけを変更します。
  • すべての書き込みはアトミックに行われ、faf-cli の安全なパスを通ります。プロジェクト外を指すリンクがあるファイルは拒否されます。
  • project.faf の編集では、コメントと値が正確に保たれます。
  • soul.fafm と Claude 自身の MEMORY.md のメモは、変更されません。
• スコアは1つです。 すべてのツールが faf-cli のスコアを表示し、✪ が表示されるのは100%の場合のみです。
• 事実はリポジトリから取得します。 空のスロットには、何を入力すればよいかが表示されます。
  • faf_auto が書き込むリポジトリからの事実。
  • faf_go で回答するリポジトリにない事実。
  • 6Ws に関するユーザー自身の情報。
• 事実を伝えるツール。
  • タイトル、ヒント、スキーマはすべてツールの動作と一致し、不正な引数は実行前に拒否されます。
  • Core 14：faf_setup と faf_tri_sync がデフォルトのリストに追加されました。
• あらゆるリポジトリで安全に使えます。
  • クローンしたリポジトリのシンボリックリンクが、AI のコンテキストに入り込むことはありません。
  • faf_go の回答によってオブジェクトが汚染されることはありません。
  • ファイルツールはアクティブなプロジェクト内で動作します。
• 実行するものをそのまま同梱します。 .mcpb は同梱されたサーバーを実行し、そのサーバーを起動して確認してから sha を記録します。Node 22+ に対応し、CI は Ubuntu、macOS、Windows 上の Node 22 と 24 で実行されます。
• 廃止： faf_clear、faf_friday、faf_guide、faf_write、project.faf への相互運用インポート、faf_check の protect／unlock。アーカイブタグ archive/cfm-v5-surface にこれらが残されています。

---

3つのW — 3つの答え。それだけです。

優れた製品はどれも、3つのWへの3つの答え、つまり Who（誰に）、What（何を）、Why（なぜ） から始まりました。

	WHO 誰のため？	WHAT 何をする？	WHY なぜ作る？
Uber	移動手段が必要な人	ボタンをタップすると、車が来る	タクシーには問題があった
Airbnb	ホテルに泊まる余裕がない旅行者	誰かの空き部屋に泊まる	空き部屋が何百万室もある
Slack	メールに追われているチーム	整理されたグループメッセージ	スレッドに埋もれた意思決定
Venmo	割り勘をする友人同士	すぐに送金する	いつも誰かが返金を忘れる

どれも同じパターンです。うまくいく製品はすべて、ここから始まります。.faf に記録しましょう。

human_context:
  who: "people who need a ride across town"
  what: "tap a button, car arrives in minutes"
  why: "taxis are slow, expensive, and hard to find"

30秒で完了します。Claude がここから project.faf を作成します。それ以降のセッションでは、AI が最初から適切な状態で始められます。

6つのW — AI を最適化する

3つのWでプロジェクトを始められます。AI を完全に最適化するには、残りも加えて一式を完成させましょう — Where（どこで）、When（いつ）、How（どうやって）：

  where: "mobile app, iOS and Android"    # where does it live?
  when: "launch in 3 months"              # when is it shipping?
  how: "GPS matching, real-time pricing"  # how does it work?

3つのWで AI を使ってプロジェクトを開始し、6つのWで AI を100％最適化できます。同じ YAML、同じファイルです。その他の例 → faf.one/ideas

---

クイックスタート

Node 22 以降が必要です。

Claude Desktop — ワンクリック

⬇ claude-faf-mcp-7.1.0.mcpb をダウンロード

Claude Desktop で開いてください。拡張機能は同梱されているサーバーを実行し（起動時に npx もネットワークも不要）、Core 14 ツールを一覧表示します。

Claude Desktop — 設定

claude_desktop_config.json に追加してから、Claude Desktop を再起動してください。

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

npm install -g claude-faf-mcp の後は、インストール済みの bin も使用できます：{ "command": "claude-faf-mcp" }。Claude Desktop の PATH に Bun があれば、{ "command": "bunx", "args": ["claude-faf-mcp"] } も使用できます。

Claude Code

claude mcp add faf -- npx -y claude-faf-mcp

バージョンの固定

npx の設定と、SessionStart フック faf_setup がインストールするもの（npx -y claude-faf-mcp --session-refresh）はバージョンが固定されていません。最新リリースが実行されるため、再インストールしなくても修正が反映され、新しいメジャーバージョンも同様に利用できます。特定のメジャーバージョンを使い続けるには、設定にバージョンを自分で記述してください："args": ["-y", "claude-faf-mcp@6"]。.mcpb はビルド元のバージョンを実行します。

次に

faf プロンプトを実行します — Claude がプロジェクトを評価し、リポジトリから補える情報を埋め、あなただけが答えられることを質問し、検証して同期します。

または、Claude に3つのWを伝えます：「[誰]のために[なぜ]、[何を]作っています」

faf-cli — 任意のターミナルで

npx faf-cli auto

同じ .faf を、あらゆる環境で利用できます — Claude、Gemini、Grok、Cursor。npm の faf-cli →

---

仕組み

You → 3 answers → project.faf → AI reads it → every session → forever

project.faf  ──→  CLAUDE.md     (faf_sync)
project.faf  ──→  MEMORY.md     (faf_tri_sync 🐘)

言語、フレームワーク、パッケージマネージャー、ビルドツールは、faf-cli が既存のファイルから検出します。人に関するコンテキストは、あなたにしか提供できない情報です。

---

Claude Code チーム向け

.faf はリポジトリに置かれます。コンテキストはコードとともに移動し、コミットされ、バージョン管理されます。

すべてのセッションは、確かなコンテキストをもとに始まります。 ネイティブの SessionStart フックを一度だけインストールします（faf_setup — まずプレビューして、設定はそのまま保持されます）。以降、すべての Claude Code セッションは、何もない状態ではなく、次の1行のハートビートとともに始まります。

faf: context ✪ 100% — fresh · +7 intent the code can't carry

この1行が情報を引き継ぎます。Claude はすでにスタックとスコアを把握しており、+N が示すのはコードでは保持できない意図、つまり、あなたにしか伝えたり確認したりできない目標と6つのWです。毎回のセッションの冒頭で「このプロジェクトが何か」を説明し直す必要はありません。

チームでの拡張性は、設計上備わっています。

commit project.faf  →  every teammate's Claude starts with the same context
git clone           →  a new dev's Claude is grounded before they write a line

• 信頼できる唯一の情報源。 faf_sync は .faf から CLAUDE.md を生成します。対象は faf 管理ブロックのみなので、独自のメモはそのまま残ります。セッションをまたいで記憶を保持するには、MEMORY.md を追加します（tri-sync 🐘）。
• ずれがありません。 スコアは決定的です。同じ .faf なら、どのマシンでも CI でも同じ数値になります。チームメイトのコンテキストが、あなたより意図せず不足することはありません。
• ローカルです。 アカウントもテレメトリーもなく、FAF に送信されるものはありません。唯一のネットワーク利用は、指定したリポジトリを、依頼したときに限ってクローンすることです（プライバシー）。コンテキストはあなたのものです。リポジトリ内で引き継がれます。

オンボーディングは git clone → 確かなコンテキストへ。 新しいチームメイトが通常なら周囲に尋ねて把握するコンテキストは、最初のクローンからすでにリポジトリ内にあり、機械可読です。

---

スコアリング：何も分からない状態から最適化まで

ティア	スコア	意味
✪ TROPHY	100%	Gold Code — AI が最適化されています
★ GOLD	99%+	ほぼ完璧なコンテキスト
◆ SILVER	95%+	優れた状態
◇ BRONZE	85%+	本番環境対応
● GREEN	70%+	確かな基盤
● YELLOW	55%+	AI がコイントスのように推測します
○ RED	<55%	AI は何も分からないまま作業します
♡ WHITE	0%	コンテキストがまったくありません

55%では、AI は半分の確率で推測します。100%では、AI はあなたのプロジェクトを把握しています。このスコアは faf-cli の scoreFafYaml で、同じファイルに対して faf score が常に出力する33という数値です。

---

MCP ツール — コア 14、FAF_TOOLS=all で 30

デフォルトでは、claude-faf-mcp は、よく使うライフサイクルツールであるコア 14 を一覧表示します。FAF_TOOLS=all を設定すると拡張ツールも一覧に表示されます。どちらの場合も、すべてのツールを名前で呼び出せます。6.0.0 で廃止：faf_clear、faf_friday、faf_guide、faf_write（名前で呼び出すと、代わりに使用するものを示す1行が返ります）、AGENTS.md / .cursorrules / GEMINI.md / conductor から project.faf へのインポート、および faf_check の保護／ロック解除。

すべてのツールは、このパッケージが依存する faf-cli 上で実行されます。PATH から実行されるものはありません。

コア

ツール	目的
faf_init	フォルダー用の project.faf を作成します（faf-cli が技術スタックを検出します）
faf_auto	リポジトリ内のファイル、続いて CLAUDE.md を基に project.faf を埋めます
faf_go	質問と回答を通じて、目標と 6W を定義します
faf_score	faf-cli による AI 対応度スコア（0～100%）
faf_bench	AI の根拠付けをベンチマークします — .faf がない状態とある状態を機械的に採点し、記録を出力します
faf_doctor	project.faf を診断します。各検出事項と、それを修正するツールを示します
faf_trust	project.faf を検証し、そのスコアの信頼性を示す記録を返します
faf_sync	project.faf から CLAUDE.md を書き込みます — agents/cursor/gemini/copilot/all では AGENTS.md / .cursorrules / GEMINI.md / copilot-instructions.md も書き込みます
faf_tri_sync	Claude Code がこのプロジェクト用に読み込む MEMORY.md に faf のブロックを書き込みます 🐘
faf_setup	プロジェクト設定に SessionStart フックをインストールします（事前にプレビューできます）
faf_context	アクティブなプロジェクトを表示または設定します。detail は .faf のテキストを返します
faf_etch	セッションをまたいで決定事項を記憶します（プロジェクトの魂、soul.fafm）
faf_recall	プロジェクトの魂から記憶を呼び出します
faf_about	.faf 形式について説明します

拡張（FAF_TOOLS=all）

ツール	目的
faf	まずはこちらから：プロジェクト、そのスコア、100% にするための手順を表示します（読み取りのみ）
faf_quick	1行から project.faf を作成します：名前、目標、言語、フレームワーク、ホスティング
faf_readme	README.md から 6W を読み取ります。apply は空のスロットのみ埋めます
faf_human_add	project.faf の 6W スロットを1つ設定します
faf_formats	faf-cli がフォルダー内で検出する形式と、faf_auto が書き込む内容を表示します（ドライラン）
faf_git	リポジトリの URL から project.faf を作成します（git でクローンするため、ネットワークを使用します）
faf_check	faf-cli の validateFaf と、各スロットの状態を表示します
faf_dna	プロジェクトの .faf-dna 系譜を表示します（読み取りのみ）
faf_status	プロジェクトに .faf があるかどうかと、その先頭行を表示します
faf_agents	AGENTS.md を書き込みます（OpenAI Codex やその他のエージェント向け）
faf_cursor	.cursorrules を書き込みます（Cursor IDE 向け）
faf_gemini	GEMINI.md を書き込みます（Google Gemini CLI 向け）
faf_conductor	Google Conductor の conductor/ ファイルを書き込みます
faf_read	アクティブなプロジェクト内のファイルを読み取ります
faf_list	アクティブなプロジェクト内のフォルダーを一覧表示します
faf_debug	アクティブなプロジェクト、書き込みアクセス、および同梱された faf-cli のバージョンを表示します

---

🐘 ネリーは忘れません

faf_sync は .faf から CLAUDE.md を書き込むため、両者の内容が一致した状態に保たれます。

tri-sync は MEMORY.md を追加し、AI がすべてのセッションを通じてプロジェクトを記憶できるようにします。

faf_sync = .faf → CLAUDE.md              ← written from .faf
tri-sync = .faf → MEMORY.md   (faf_sync writes CLAUDE.md)  ← Nelly never forgets 🐘

プロ向け機能ですが、開発者は無料で利用できます。Teams & Enterprise：faf.one/pro（プラン）

---

.FAF の位置づけ

Model        Context          Protocol
─────        ───────          ────────
Claude    →   .faf        →    MCP
Gemini    →   .faf        →    MCP
Codex     →   .faf        →    MCP
Any LLM   →   .faf        →    MCP

IANA に登録済み（application/vnd.faf+yaml）。1つのファイル、1つの形式。一度定義すれば、どこでも使えます。

---

エコシステム

パッケージ	プラットフォーム	レジストリ
claude-faf-mcp（本パッケージ）	Claude	npm
faf-cli	CLI	npm + Homebrew
gemini-faf-mcp	Google Gemini	PyPI
grok-faf-mcp	xAI Grok	npm
rust-faf-mcp	Rust	crates.io
faf-wasm	ブラウザー／Edge	npm
Chrome Extension	ブラウザー	Chrome Web Store

同じ project.faf。同じスコアリング。同じ結果。実行レイヤーは異なります。

---

品質

テストは ubuntu、macOS、Windows 上で bun を使って実行します。ビルド済みパッケージは、3 つすべてのプラットフォームで Node 22 および 24 にパッケージとしてまとめてインストールし、起動します。CI →

---

プライバシー

claude-faf-mcp はお使いのマシン上で動作します。分析、テレメトリー、アカウントはありません。ネットワークを使用するのは faf_git のみで、リポジトリの読み取りを依頼した場合に限られます。その際、指定された URL から git でクローンします。書き込まれるファイルは**プライバシーポリシー →**に記載されています。

---

claude-faf-mcp が役に立った場合は、リポジトリにスターを付けることをご検討ください。他の人が見つけやすくなります。

---

引用

claude-faf-mcp または .faf／.fafm／.fafa 形式を研究や本番環境で使用する場合は、形式に関する論文を引用してください。

Wolfe, J. (2025). Format-Driven AI Context Architecture: The .faf Standard for Persistent Project Understanding. Zenodo. https://doi.org/10.5281/zenodo.18251362

Wolfe, J. (2026). Permanent Memory and Instant Recall: The .fafm Standard for Multi-Profile AI Agent Memory. Zenodo. https://doi.org/10.5281/zenodo.20348942

Wolfe, J. (2026). Why Agents Need a Passport: .fafa — Portable Identity for the Agentic Era. Zenodo. https://doi.org/10.5281/zenodo.21951641

BibTeX

@article{wolfe2025faf,
  title     = {Format-Driven AI Context Architecture: The .faf Standard for Persistent Project Understanding},
  author    = {Wolfe, James},
  year      = {2025},
  month     = {nov},
  publisher = {Zenodo},
  doi       = {10.5281/zenodo.18251362},
  url       = {https://doi.org/10.5281/zenodo.18251362}
}

@article{wolfe2026fafm,
  title     = {Permanent Memory and Instant Recall: The .fafm Standard for Multi-Profile AI Agent Memory},
  author    = {Wolfe, James},
  year      = {2026},
  month     = {may},
  publisher = {Zenodo},
  doi       = {10.5281/zenodo.20348942},
  url       = {https://doi.org/10.5281/zenodo.20348942}
}

@article{wolfe2026fafa,
  title     = {Why Agents Need a Passport: .fafa — Portable Identity for the Agentic Era},
  author    = {Wolfe, James},
  year      = {2026},
  month     = {aug},
  publisher = {Zenodo},
  doi       = {10.5281/zenodo.21951641},
  url       = {https://doi.org/10.5281/zenodo.21951641}
}

ライセンス

MIT — 無料のオープンソース

---

FAF ファミリー

faf-cli	npx faf-cli init — あらゆるプロジェクト向けに .faf を作成
claude-faf-mcp	Claude Desktop 向け MCP サーバー
gemini-faf-mcp	Gemini CLI 向け MCP サーバー
grok-faf-mcp	Grok 向け MCP サーバー
faf-mcp	Cursor、Windsurf、Cline、VS Code 向け MCP サーバー
rust-faf-mcp	Rust 製 MCP サーバー
faf-skills	.faf 向け Claude Code スキル
faf.one	ブログ、ダウンロード、ドキュメント
IANA: vnd.faf+yaml	コンテキスト形式（2025-10-30）
IANA: vnd.fafm+yaml	メモリー形式（2026-05-13）

形式 | 駆動 🏎️⚡️ wolfejam.dev

---

CLI を入手

faf-cli — 元祖 AI コンテキスト CLI。すべてのビルダーに必須です。

npx faf-cli auto

MCP Registry： one.faf/claude-faf-mcp · IANA 登録 2 件： vnd.faf+yaml（コンテキスト） · vnd.fafm+yaml（メモリー） · faf.one · npm

---

設定不要。コンテキストが、すべてのセッションで常に利用できます。