rust-faf-mcp

AIセッションのたびにプロジェクトを説明するのはやめましょう。 1つの .faf ファイルがあなたのプロジェクトのDNAを記録します。AIはそれを一度読み込むだけで、あなたが何を構築しているのかを理解します。

FAF 用のRust製 MCP (Model Context Protocol) サーバー — YAML形式 (application/vnd.faf+yaml) で構造化されたAIプロジェクトコンテキストを提供します。シングルバイナリ、stdioトランスポート、ストリップ済みで4.3 MB。rmcp および faf-rust-sdk を基盤として構築されています。

クイックスタート

cargo install rust-faf-mcp

次に、任意のMCPクライアントで指定します：

# Claude Code
claude mcp add faf rust-faf-mcp

// WARP / Cursor / Zed / Claude Desktop — any stdio MCP client
{
  "mcpServers": {
    "faf": {
      "command": "rust-faf-mcp"
    }
  }
}

フラグや設定ファイル、ネットワークリスナーは不要です。純粋なstdio JSON-RPCです。

またはHomebrew (macOS, ビルド済み) を使用する場合：

brew install Wolfe-Jam/faf/rust-faf-mcp

Related MCP server: gemini-faf-mcp

1つのコマンドで、永遠に完了

faf_auto はプロジェクトを検出し、.faf を作成し、スコアを最大化し、CLAUDE.md を同期します — これらすべてを一度に行います：

faf_auto complete
━━━━━━━━━━━━━━━━━
Score: 0% → 85% (+85) 🥈 Silver
Steps:
  1. Created project.faf
  2. Second enhancement pass
  3. Created CLAUDE.md

Path: /home/user/my-project

生成されるもの：

# project.faf — your project, machine-readable
faf_version: "3.3"
project:
  name: my-api
  goal: REST API for user management
  main_language: Rust
  version: "0.1.0"
  license: MIT
instant_context:
  what_building: REST API for user management
  tech_stack: Rust 2021
  key_files:
    - Cargo.toml
    - src/main.rs
    - README.md
  commands:
    build: cargo build
    test: cargo test
stack:
  backend: Rust
  build_tool: cargo

すべてのAIエージェントがこれを一度読み込むだけで、あなたが何を構築しているのかを正確に把握します。20分間のオンボーディングも、誤った前提も不要です。

ツール

作成と検出

スコアリングと検証

最適化

faf_init は反復可能です — 再実行することで不足している情報が埋められ、スコアが毎回向上します。

アーキテクチャ

src/
├── main.rs      # ~20 lines — tokio entry, rmcp stdio transport
├── server.rs    # FafServer: #[tool_router], ServerHandler, resources
└── tools.rs     # Business logic — all 9 tools, pure functions returning Value

• ランタイム: tokio シングルスレッド (current_thread)

• HTTP: reqwest 非同期 (faf_git がGitHub API用に使用)

• SDK: 解析、検証、圧縮、検出用の faf-rust-sdk 1.3

• サーバー: #[tool_router] マクロを使用した rmcp 1.1 — JSON-RPC、スキーマ生成、トランスポートを処理

ツールは serde_json::Value を返します。サーバーはそれらをrmcpの IntoCallToolResult 用に Result<String, String> へ適応させます。

テスト

6ファイルにわたる112のテスト：

cargo test    # runs all 112

テストはコンパイルされたバイナリをサブプロセスとして起動し、stdin/stdout JSON-RPCを介して通信します — 実際のサーバーに対する真の統合テストです。

FAFエコシステム

1つのフォーマットで、あらゆるAIプラットフォームに対応。

ソースからのビルド

git clone https://github.com/Wolfe-Jam/rust-faf-mcp
cd rust-faf-mcp
cargo build --release
# Binary at target/release/rust-faf-mcp (4.3 MB)

エディション: 2021 | LTO: 有効 | ストリップ: シンボル

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

リンク

• crates.io/crates/rust-faf-mcp

• faf-rust-sdk — 依存しているパーサー

• faf.one — FAFホーム

• IANA登録 — application/vnd.faf+yaml

• CHANGELOG

ライセンス

MIT

Built by @wolfe_jam | wolfejam.dev