Flyto Indexer

🚀 Flyto Indexer

AIアシスタントに影響分析、クロスプロジェクト参照追跡、コードの健全性スコアリングを提供するMCPサーバー。ゼロ依存関係。純粋なPython。100%ローカルで動作します。

🚀 クイックスタート

Flyto Indexerを使用することで、AIアシスタントに影響分析、クロスプロジェクト参照追跡、コードの健全性スコアリングを提供できます。以下に、Flyto Indexerの使用例を示します。

Flyto Indexerを使用しない場合

You:    "validateOrderをvalidate_orderにリネームする"

AI:     *関数をリネームする*
        *"validateOrder"をgrepする*
        *同じプロジェクト内で3つのマッチを見つける*
        *フロントエンドリポジトリ内の4つの呼び出し元を見逃す*
        *それにルーティングするAPIエンドポイントを見逃す*
        *壊れたコードをプッシュする*

Flyto Indexerを使用する場合

You:    "validateOrderをvalidate_orderにリネームする"

AI:     → impact_analysis("validateOrder")

        ⚠️ 3つのプロジェクトにまたがる7つの呼び出しサイト:
          backend/checkout.py:42     — validateOrder()を呼び出す
          backend/api/orders.py:18   — validateOrderをインポートする
          frontend/Cart.vue:55       — useCheckout()を介して呼び出す
          frontend/QuickBuy.vue:23   — useCheckout()を介して呼び出す
          mobile/OrderScreen.tsx:67  — /api/validateへのAPI呼び出し
          tests/test_orders.py:12    — 単体テスト
          tests/test_api.py:88       — 統合テスト
          リスク: 高 — 3つのプロジェクトに影響を及ぼす

        → edit_impact_preview("validateOrder", change_type="rename")
        *7つの呼び出しサイトをすべてリネームし、テストを更新し、きれいなコードをプッシュする*

これがFlyto Indexerを使用することの違いです。 grepはテキストを見つけますが、Flyto Indexerは依存関係を見つけます。

📦 インストール

pip install flyto-indexer
flyto-index setup .

以上です。1つのコマンドですべての作業が完了します。

1. スキャン：プロジェクトをスキャンし、コードインデックスを構築します。
2. 書き込み：ツールの使用方法を記載したCLAUDE.mdを書き込みます。
3. 設定：Claude Code MCPの設定（~/.claude/settings.json）を構成します。

Claude Codeを再起動して使用を開始します。Claude Code、Cursor、Windsurfなど、任意のMCPクライアントで動作します。

{
  "mcpServers": {
    "flyto-indexer": {
      "command": "python3",
      "args": ["-m", "flyto_indexer.mcp_server"]
    }
  }
}

flyto-index scan .
flyto-index setup-claude .

git clone https://github.com/flytohub/flyto-indexer.git
cd flyto-indexer && pip install -e .
flyto-index setup .

flyto-index setup . --remove
pip uninstall flyto-indexer

✨ 主な機能

影響分析 — 核心機能

AIが既に持っているすべてのツール（grep、ファイル読み取り、グロブ）はテキストを見つけます。しかし、「これに依存しているものは何か？」 という質問に答えることはできません。

impact_analysisは逆依存関係グラフを構築し、何が壊れるかを正確に教えてくれます。

→ impact_analysis("useAuth")

  4つのプロジェクトにまたがる12の参照:
    flyto-cloud:  LoginPage.vue, RegisterPage.vue, AuthGuard.ts, api.ts
    flyto-pro:    vscode_agent/tools.py, middleware/auth.py
    flyto-vscode: ChatHandler.ts, AuthProvider.ts
    flyto-core:   modules/auth/login.py
  リスク: 高 — 4つのプロジェクトで共有されている

→ edit_impact_preview("useAuth", change_type="signature_change")
  各呼び出しサイトで更新が必要な正確なコード行を表示します。

クロス言語API追跡

Pythonバックエンドのエンドポイントは、TypeScript/Vueフロントエンドの呼び出し元と自動的にリンクされます。

→ list_apis()

  POST /api/checkout
    定義場所: backend/routes/order.py (create_order)
    呼び出し元:   frontend/Cart.vue, frontend/api/orders.ts
    呼び出し回数: 4

FastAPI、Flask、Starletteのデコレータとfetch()、axios、$httpの呼び出しを検出します。

コードの健全性とセキュリティ

→ code_health_score()            → security_scan()

  スコア: 74/100 (C)               重大な問題: ハードコードされたAPIキー
  複雑度:    22/25             高レベルの問題: SQL文字列の連結
  未使用コード: 18/25             中レベルの問題: 0
  ドキュメント: 16/25
  モジュール性:    18/25

→ suggest_refactoring()

  [高]   process_data() — 87行、深さ=6 → サブ関数を抽出する
  [中]   dead_fn() — 参照されていない、45行 → 安全に削除できる
  [低]    utils.py — 800行 → 焦点を絞ったモジュールに分割する

タスク分析 — コーディング前に計画する

analyze_taskは6つの次元でリスクをスコアリングし、具体的なツール呼び出しシーケンスを含む実行計画を生成します。

→ analyze_task("validateOrderをvalidate_orderにリネームする", intent="refactor")

  次元:
    影響範囲:      高 (8.0)  — 3つのプロジェクトにまたがる7つの呼び出し元
    破壊リスク:     高 (7.0)  — パブリックAPI、外部の消費者によって使用されている
    テストリスク:     中 (5.0) — 7つの呼び出し元のうち2つがテストカバレッジを持っている
    クロスカップリング:    高 (8.0)  — 3つのプロジェクトで参照されている
    複雑度:        低 (2.0)   — 単純なリネーム
    ロールバックの難易度: 中 (5.0) — 複数のプロジェクトでの変更

  戦略: safe_refactor (影響範囲のため、minimal_diffからアップグレード)

  実行計画:
    1. scope_callers       → find_references("validateOrder")
    2. verify_test_coverage → find_test_file("checkout.py")
    3. check_cross_project → cross_project_impact("validateOrder")
    4. gate_before_plan    → task_gate_check(phase="plan")
    5. preview_changes     → edit_impact_preview("validateOrder", "rename")
    6. gate_before_apply   → task_gate_check(phase="apply")

各ステップには事前に埋め込まれた引数と依存関係があり、AIはプロンプトではなくデータ構造に従います。

📚 ドキュメント

ツール

32のMCPツールがあり、それらの機能別に整理されています。

影響と依存関係 — このツールをインストールする理由

タスク分析 — コーディング前に計画する

コード品質 — レビュー前に問題を発見する

サポートする言語

動作原理

flyto-index scan .

1. 解析 — AST（Python）または正規表現（その他）を使用して、すべての関数、クラス、インポートを抽出します。
2. グラフ構築 — 依存関係グラフと逆インデックス（呼び出し元 → 呼び出し先）を構築します。
3. サーバー起動 — MCPサーバーがメモリ内のグラフからクエリに応答します。
4. インクリメンタル更新 — 変更されたファイルのみを再スキャンします（コンテンツハッシュ追跡）。

.flyto-index/
├── index.json       # シンボル + 依存関係グラフ + 逆インデックス
├── content.jsonl    # ソースコード（遅延読み込み）
├── bm25.json        # 検索インデックス
└── manifest.json    # 変更追跡

CI: 危険な変更をブロックする

# 変更が多くの呼び出しサイトに影響を与える場合、PRを失敗させる
- run: pip install flyto-indexer
- run: flyto-index scan .
- run: flyto-index check . --threshold medium --base main

CLI

flyto-index setup .                       # 1つのコマンドで：スキャン + CLAUDE.md + MCP設定
flyto-index scan .                        # インデックス作成（または再作成）
flyto-index impact useAuth --path .       # 影響分析
flyto-index check . --threshold medium    # CIゲート
flyto-index demo .                        # 30秒のデモ
flyto-index install-hook .                # コミット時に自動的に再インデックス作成
flyto-index setup . --remove              # アンインストール

プライバシー

100%ローカルで動作します。コードはどこにも送信されません。.flyto-index/を削除することで完全にクリーンアップできます。

制限事項

• 静的解析のみ — 動的インポートとメタプログラミングは追跡されません。
• 型推論なし — 複雑なTypeScriptジェネリクスは簡略化されます。
• クロスプロジェクト追跡には、すべてのプロジェクトを一緒にインデックスする必要があります。

📄 ライセンス

MIT