Fossil Mcp

Fossil MCP

バイブコーディング時代のコード品質ツールキット。

バイブコーディングが残していく乱れ — デッドコード、重複ロジック、足場（スキャフォールディング）の名残、接続されていない関数 — を 16 言語にわたって発見する静的解析。

fossil-mcp.com

問題

AI 支援コーディングは問題ありません — コードをレビューし、アーキテクチャを理解し、主導権を保ちます。バイブコーディングは違います。 欲しいものを説明すると AI が書き、あなたはすべての行を読むことなく出荷します。Claude Code、Cursor、GitHub Copilot、Windsurf といったツールは、このワークフローを高速で生産的にします。しかし何日も何週間も経つうちに、バイブコーディングされたプロジェクトには、従来のリンターでは捕捉できない特定の種類の問題が蓄積されます。

デッドコードは急速に積み上がります。 AI が関数をリファクタリングするとき、新しいバージョンを書きますが、古いものを削除するのをしばしば忘れます。diff を 1 行ずつ読んでいないので気づきません。複数のセッションを経て、未使用の関数、到達不能な分岐、孤立したユーティリティが積み上がります — コードベースは成長するのに、何も刈り込まれません。METR の研究では、開発者が AI の出力の確認とデバッグにかなりの時間を費やしていることが分かりました。デッドコードはこれを指数関数的に難しくします。

重複は静かに広がります。 AI の各セッションには限られたコンテキストウィンドウがあります。すでに別の場所に存在するユーティリティ関数を生成したり、同じ問題を 3 つ先のファイルでわずかに異なる実装で解決したりします。機能を依頼し、それが動作するので、次に進みます。従来の重複検出はコピー＆ペーストに焦点を当てています — バイブコーディングの重複は構造的です。似たロジック、異なる名前、モジュール全体に散在しています。

// Phase 1、// TODO、// Step 2 — どこにでも。 AI エージェントはフェーズ単位で作業します。一時的なはずだった足場のマーカーを残します。// Phase 1: Setup、// TODO: implement error handling、pass や todo!() を使ったプレースホルダーの関数本体、process_data_v2 のようなフェーズ付きの命名などです。バイブコーディングでは、誰もこれらを片付けに戻りません。それらは恒久的なものになります。

何からも呼ばれない関数が存在します。 これがバイブコーディングの特徴です。AI はヘルパー関数を書き、それを使い、後のセッションで呼び出し側を別のアプローチを使うように書き換えます — しかしヘルパーは残ります。コールグラフがなければ、あなたも AI も、どの関数が実際にコードベースの残りの部分と接続されているかを判断できません。現在の AI コーディングツールは、関数が互いをどう呼び出すかを理解するのではなく、テキスト検索でコードをナビゲートします。

一時ファイルがリポジトリに蓄積します。 AI セッションは temp_、backup_、old_、phase_1_ というファイルやディレクトリを作成します。バイブコーディングでは、各セッションの後にファイルツリーを監査したりしません。これらの成果物はコミットをまたいで残り続けます。

解決策

Fossil MCP は、バイブコーディングされたプロジェクトのために専用に作られた静的解析ツールキットです。AI がコードの大部分を書くときに蓄積される成果物を検出します — そして開発者向けの CLI ツールとしても、AI エージェントに単なるテキスト検索ではなくコードグラフを与える MCP サーバーとしても動作します。

  ███████╗ ██████╗ ███████╗███████╗██╗██╗           ()    ()
  ██╔════╝██╔═══██╗██╔════╝██╔════╝██║██║            \    /
  █████╗  ██║   ██║███████╗███████╗██║██║             |  |
  ██╔══╝  ██║   ██║╚════██║╚════██║██║██║             |  |
  ██║     ╚██████╔╝███████║███████║██║███████╗       /    \
  ╚═╝      ╚═════╝ ╚══════╝╚══════╝╚═╝╚══════╝      ()    ()
  Dig up dead code. Unearth clones. Expose scaffolding.

Fossil が検出するもの

Fossil が他と異なる点

• バイブコーディングのために専用設計。 汎用リンターではありません — AI がコードの大半を書き、人間がレビューする割合が減ったときに蓄積する乱雑さを特に対象としています。
• grep ではなくグラフ。 AI コーディングツールはテキストを検索してコードをナビゲートします。Fossil はコールグラフを構築し、エージェントが関数のつながりを追跡し、リファクタリング前に影響範囲を見つけ、行き止まりを発見できるようにします — すべてのファイルを読むことなく。
• MCP ネイティブ。 MCP サーバーとして動作するため、AI エージェントが開発中に自身の出力をセルフチェックできます。
• トークンを節約し、コストも節約。 エージェントが問題を見つけるために何度もファイルをスキャンする代わりに、Fossil はデッドコード、クローン、スキャフォールディングを 1 回のパスで特定します — LLM 推論の回数が減り、コストも下がります。
• Rust 製。 単一バイナリで、ランタイム依存関係はありません。数千のファイルを数秒でスキャンします。設計上メモリセーフです。
• クロスファイル分析。 インポート、バレル再エクスポート、クラス階層を解決し、モジュール境界を越えてデッドコードを見つけます。
• フレームワーク対応。 React、Next.js、Django、Spring、Axum などを自動検出します — ライフサイクルメソッドをデッドコードとして誤検出しません。
• 設定不要。 すぐに動作します。設定ファイルは任意です。
• 16 言語対応。 多言語コードベースに対応する 1 つのツールです。

インストール

クイックインストール (推奨)

macOS / Linux:

curl -fsSL fossil-mcp.com/install.sh | sh

Windows (PowerShell):

irm fossil-mcp.com/install.ps1 | iex

OS とアーキテクチャを自動検出し、最新のバイナリをダウンロードして PATH に追加します。

手動ダウンロード

お使いのプラットフォーム向けの最新バイナリを GitHub Releases からダウンロードしてください:

# macOS (Apple Silicon)
curl -L https://github.com/yfedoseev/fossil-mcp/releases/latest/download/fossil-mcp-macos-aarch64.tar.gz | tar xz
mv fossil-mcp /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/yfedoseev/fossil-mcp/releases/latest/download/fossil-mcp-macos-x86_64.tar.gz | tar xz
mv fossil-mcp /usr/local/bin/

# Linux (x86_64)
curl -L https://github.com/yfedoseev/fossil-mcp/releases/latest/download/fossil-mcp-linux-x86_64-musl.tar.gz | tar xz
mv fossil-mcp ~/.local/bin/

cargo-binstall

cargo-binstall をお持ちであれば、ソースからコンパイルする代わりにビルド済みバイナリをダウンロードします:

cargo binstall fossil-mcp

crates.io から

cargo install fossil-mcp

crates.io からソースをダウンロードし、ローカルでコンパイルします。Rust ツールチェーンが必要です。

ソースから

git clone https://github.com/yfedoseev/fossil-mcp.git
cd fossil-mcp
cargo build --release

バイナリは ./target/release/fossil-mcp にあります。

更新

fossil-mcp update

MCP サーバーのセットアップ

Fossil はデフォルトで MCP サーバーとして動作します — 引数なしで fossil-mcp を実行するだけです。お使いの AI コーディングツールに接続してください：

claude mcp add fossil fossil-mcp

{
  "mcpServers": {
    "fossil": {
      "command": "fossil-mcp"
    }
  }
}

{
  "mcpServers": {
    "fossil": {
      "command": "fossil-mcp"
    }
  }
}

{
  "mcp": {
    "servers": {
      "fossil": {
        "command": "fossil-mcp"
      }
    }
  }
}

{
  "mcpServers": {
    "fossil": {
      "command": "fossil-mcp"
    }
  }
}

{
  "mcpServers": {
    "fossil": {
      "command": "fossil-mcp"
    }
  }
}

MCP ツール

接続すると、AI エージェントは以下のツールを利用できるようになります：

CLI の使用方法

モード

Fossil には 4 つの動作モードがあります：

インタラクティブモード

引数なしで fossil-mcp を実行する（または fossil-mcp scan . を実行する）と、現在のディレクトリをスキャンしてデッドコード、クローン、スキャフォールディングを検出し、ダッシュボードを表示した後、インタラクティブ REPL に入ります：

  FOSSIL Scanning .
  ────────────────────────────────────────────────
   ✓  1200 nodes analyzed, 42 unreachable
   ✓  380 files analyzed, 8 clone groups
   ✓  3 scaffolding artifacts

  ══════════════════════════════════════════════════
  RESULTS  53  findings across 28 files
  ══════════════════════════════════════════════════

  ▐ Dead Code     42   ██████████████░░
  ▐ Clones         8   ██░░░░░░░░░░░░░░    120 duplicated lines
  ▐ Scaffolding    3   █░░░░░░░░░░░░░░░

  fossil>

REPL コマンド

すべての探索コマンドは、オプションの件数と言語フィルターをサポートしています：command [N] [lang]

fossil> dead 10                  # Top 10 dead code findings
fossil> dead 20 typescript       # Top 20 dead code in TypeScript
fossil> clones 5 rust            # Top 5 clone groups in Rust
fossil> scaffolding              # All scaffolding findings
fossil> scaffolding 10 python    # Top 10 scaffolding in Python
fossil> hotspots                 # Files with most findings
fossil> hotspots 10 go           # Top 10 hotspot files in Go
fossil> file auth.ts             # All findings in a specific file
fossil> langs                    # Language breakdown
fossil> export sarif             # Export full SARIF report
fossil> summary                  # Re-show dashboard
fossil> q                        # Quit

コマンド

fossil-mcp scan [path]

インタラクティブダッシュボードを使用して、すべての分析（デッドコード + クローン + スキャフォールディング）を実行します。

fossil-mcp scan .
fossil-mcp scan /path/to/project --format sarif -o results.sarif
fossil-mcp scan /path/to/project --format json

fossil-mcp dead-code [path]

デッドコード検出のみを実行します。

fossil-mcp dead-code .
fossil-mcp dead-code . --min-confidence high
fossil-mcp dead-code . --min-lines 10
fossil-mcp dead-code . --language rust,python
fossil-mcp dead-code . --diff main                  # Only changed files
fossil-mcp dead-code . --stats                      # Show graph statistics
fossil-mcp dead-code . --cache-dir .fossil-cache     # Persistent cache
fossil-mcp dead-code . --cache-stats                 # Cache hit rate

fossil-mcp clones [path]

クローン（重複コード）検出のみを行います。

fossil-mcp clones .
fossil-mcp clones . --min-lines 10
fossil-mcp clones . --similarity 0.9
fossil-mcp clones . --language typescript
fossil-mcp clones . --types type1,type2

fossil-mcp scaffolding [path]

AI が生成した足場（スキャフォールディング）の痕跡を検出します。

fossil-mcp scaffolding .
fossil-mcp scaffolding . --language rust
fossil-mcp scaffolding . --include-todos
fossil-mcp scaffolding . --format json

検出対象: プレースホルダーの本体（pass、todo!()、unimplemented!()）、段階的なコメント（Phase 1、Step 2）、スキャフォールディングの識別子（scaffold_*、boilerplate_*）、デバッグ出力、一時ファイル（temp_*、backup_*、old_*）。

fossil-mcp check [path]

CI/CD モード — しきい値を超えるとビルドを失敗させます。詳細は CI/CD 統合 を参照してください。

fossil-mcp check
fossil-mcp check --max-dead-code 10 --max-clones 5
fossil-mcp check --diff origin/main
fossil-mcp check --diff origin/main --format sarif
fossil-mcp check --fail-on-scaffolding

fossil-mcp weekly

オープンソースプロジェクト全体の週間 AI スロップランキングを表示します。

fossil-mcp weekly
fossil-mcp weekly --detailed

fossil-mcp update

fossil-mcp を最新バージョンに更新します。

fossil-mcp update
fossil-mcp update --check    # Check without installing

fossil-mcp mcp

MCP サーバーを明示的に起動します（通常はパイプされた stdin を介して自動検出されます）。

グローバルフラグ

これらのフラグはすべてのコマンドで使用できます:

対応言語

設定（任意）

Fossil はゼロ設定で動作します。すべての設定には適切なデフォルト値があります。動作をカスタマイズする必要がある場合は、プロジェクトルートに fossil.toml を作成してください:

[dead_code]
min_confidence = "high"       # low, medium, high, certain
include_tests = false
exclude_patterns = ["generated/**", "vendor/**"]

[clones]
min_lines = 6
similarity_threshold = 0.8

[entry_points]
# Mark additional functions as entry points (won't be flagged as dead)
functions = ["custom_handler", "my_entry"]
# Additional entry point attributes/decorators
attributes = ["MyFramework::route"]
# Framework presets (auto-detected by default)
presets = ["axum", "react"]
auto_detect_presets = true

設定は次のファイル名から自動検出されます: fossil.toml、.fossil.toml、fossil.yml、fossil.yaml、fossil.json。

環境変数は設定ファイルの値を上書きします:

フレームワークプリセット

プリセットはプロジェクトの依存関係から自動検出されます。これらは Fossil に対して、どの関数がフレームワークのエントリーポイント (ライフサイクルフック、ルートハンドラーなど) であるかを伝え、デッドコードとして検出されないようにします:

CI/CD 統合

Fossil には CI/CD パイプライン向けの check コマンドが含まれています。コード品質のしきい値を超えた場合にビルドを失敗させ、チームがコード標準を徹底し、技術的負債の蓄積を防ぐのに役立ちます。

基本的な使い方

# Check against configured thresholds
fossil-mcp check

# Override thresholds via CLI
fossil-mcp check --max-dead-code 10 --max-clones 5

# Diff-aware mode (only analyze changed files in PR)
fossil-mcp check --diff origin/main

# Generate SARIF for GitHub code scanning
fossil-mcp check --diff origin/main --format sarif

# Quiet mode (no diagnostic output)
fossil-mcp check --quiet

設定

fossil.toml に [ci] セクションを追加します:

[ci]
max_dead_code = 10           # Maximum dead code findings (0 = fail on any)
max_clones = 5               # Maximum clone findings
max_scaffolding = 3          # Maximum scaffolding findings
min_confidence = "medium"    # Minimum confidence (low|medium|high|certain)
fail_on_scaffolding = false  # Fail if any scaffolding found

GitHub Actions 統合

.github/workflows/fossil-check.yml を作成します:

name: Fossil CI Check

on:
  pull_request:
  push:
    branches: [main]

jobs:
  fossil:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Install Fossil
        run: curl -fsSL fossil-mcp.com/install.sh | sh

      - name: Run Fossil check
        run: |
          fossil-mcp check \
            --diff origin/${{ github.base_ref || 'main' }} \
            --format sarif \
            > fossil-results.sarif

      - name: Upload to GitHub Security
        if: always()
        uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: fossil-results.sarif

仕組み

1. scan と同じ分析エンジンを使用してプロジェクトを スキャン します
2. 変更されたファイルのみに オプションで絞り込み ます (--diff branch 経由)
3. 設定されたしきい値に対して 評価 します
4. 検出結果をテキスト、JSON、または SARIF として レポート します
5. しきい値を超えた場合はコード 1 で 終了 します (CI ビルドが失敗)

終了コード

完全な例については、examples/fossil.toml と examples/fossil-check.yml を参照してください。

仕組み

1. スキャン — プロジェクトのファイルを走査し、.gitignore を尊重し、ベンダー提供/生成されたコードをスキップします
2. パース — 各ソースファイルの tree-sitter AST を構築します (16 言語)
3. 抽出 — AST から関数、呼び出し、インポート、属性、クラス階層を抽出します
4. グラフ — インポート解決とバレル再エクスポートのサポートを備えたクロスファイルの CodeGraph を構築します
5. 分析 — エントリーポイントを検出し (ヒューリスティクス + フレームワークプリセット経由)、到達可能性分析を実行し、デッドコードとクローンを特定します
6. レポート — 検出結果をテキストダッシュボード、JSON、または SARIF として出力します

コントリビューション

コントリビューションを歓迎します！ガイドラインについては CONTRIBUTING.md を参照してください。

• 行動規範
• セキュリティポリシー

ライセンス

Apache License, Version 2.0 または MIT License のいずれかお好みの方の下でライセンスされています。