FileScopeMCP

あなたのAIはすでにコーディングの方法を知っています。今度はあなたのコードベースを知る番です。

FileScopeMCPはあなたのコードを監視し、すべてのファイルの重要度をランク付けし、すべての依存関係をマッピングし、AIが生成した要約をバックグラウンドで常に最新の状態に保ちます。LLMが「このファイルは何をするもの？」と尋ねたとき、ソースコードを読み込ませることなく、正確な回答を得ることができます。

Claude Code、Cursor AI、またはスタンドアロンのデーモンとして動作します。標準で12の言語をサポートしています。

主な機能

重要度ランキング — 依存関係の数、エクスポート内容、配置場所に基づいて、すべてのファイルが0〜10でスコアリングされます。LLMは重要なファイルを優先的に認識します。

依存関係マッピング — Python、JS/TS、C/C++、Rust、Go、Ruby、Lua、Zig、PHP、C#、Javaにわたる双方向のインポート追跡。循環依存関係も検出します。

常に最新 — ファイル監視機能とセマンティックな変更検知により、メタデータが自動的に更新されます。TS/JSはASTレベルの差分検知、それ以外はLLMによる分析を行います。実際に変更されたものだけを再処理します。

LLMブローカー — バックグラウンドプロセスが、llama.cppの llama-server（またはOpenAI互換のHTTP API）を通じてすべてのAI作業を調整します。優先順位付きキューにより、対話型クエリがバックグラウンド処理よりも優先されます。単一のGPUで動作します。

Nexusダッシュボード — localhost:1234 で動作するWeb UI。すべてのリポジトリにわたるコードベースを視覚的に探索できます。インタラクティブな依存関係グラフ、ファイル詳細パネル、ライブブローカーアクティビティ、リポジトリごとの健全性監視を提供します。

Related MCP server: GonMCPtool

クイックスタート

git clone https://github.com/admica/FileScopeMCP.git
cd FileScopeMCP
./build.sh          # installs deps, compiles, registers with Claude Code

以上です。任意のプロジェクトでClaude Codeセッションを開くと、FileScopeMCPが自動的に初期化されます。以下を試してください：

find_important_files(limit: 5)
status()

AIによる要約が必要ですか？ ./setup-llm.sh を実行して、プラットフォーム固有のガイドに従いllama.cppの llama-server をセットアップしてください。詳細は docs/llm-setup.md を参照してください。これを行わなくても、他の機能はすべて動作します。

プロジェクトの .gitignore に以下を追加してください：

.filescope/
.filescope-daemon.log

MCPツール

Nexusダッシュボード

npm run nexus       # opens at http://localhost:1234

マシン上のすべてのFileScopeMCPリポジトリに接続する読み取り専用のWebダッシュボードです：

• プロジェクトビュー — 重要度によるヒートカラーと鮮度インジケーター付きのファイルツリー。ファイルをクリックすると詳細メタデータを表示

• 依存関係グラフ — インタラクティブなCytoscape.jsによる可視化。ディレクトリによるフィルタリングやノードクリックによる調査が可能

• システムビュー — ライブブローカー状態、リポジトリごとのトークン使用量、ストリーミングアクティビティログ

• 設定 — 表示するリポジトリの管理、ブラックリストからの削除や復元

.filescope/data.db ディレクトリをスキャンしてリポジトリを自動検出します。設定は不要です。

仕組み

Your code changes
    → file watcher picks it up
    → AST diff classifies the change (exports? types? body only?)
    → importance scores recalculated
    → staleness cascades to dependents (only if exports/types changed)
    → LLM broker regenerates summaries, concepts, change impact
    → your AI's next query gets fresh answers

すべてはプロジェクトごとの .filescope/data.db（SQLite、WALモード）に保存されます。ブローカーは ~/.filescope/broker.sock のUnixソケットを介して、すべてのリポジトリのLLM作業を調整します。

ドキュメント

ライセンス

Copyright (c) 2026 admica. All rights reserved. LICENSE を参照してください。