Filescope

🚀 ファイル作用域

このMCP（多プロトコル通信）サーバーは、主にプロジェクト内のファイルとその依存関係を分析および管理するために使用されます。開発者がプロジェクトの構造、重要なファイル、およびそれらの関係を迅速に把握し、チャートの生成やファイルの要約設定などの機能を提供します。

🚀 クイックスタート

このMCPサーバーを使用することで、プロジェクト内のファイルとその依存関係を効率的に分析および管理できます。以下の各機能モジュールを使って、必要な操作を行うことができます。

✨ 主な機能

1. ファイルツリー管理

• list_saved_trees: 保存されているすべてのファイルツリー構成をリスト表示します。
• create_file_tree: 指定されたディレクトリの分析用に、新しいファイルツリー構成を作成します。
• select_file_tree: 既存のファイルツリー構成を選択して操作を行います。
• delete_file_tree: 特定のファイルツリー構成を削除します。

2. ファイル分析

• list_files: プロジェクト内のすべてのファイルとその重要度スコアをリスト表示します。
• get_file_importance: 指定されたファイルの詳細情報（依存関係や被依存関係を含む）を取得します。
• find_important_files: 設定された基準に基づいて、最も重要なファイルをフィルタリングします。
• read_file_content: 特定のファイルの内容を読み取ります。
• recalculate_importance: すべてのファイルの重要度スコアを再計算します。

3. ファイル要約

• get_file_summary: 指定されたファイルの保存要約情報を取得します。
• set_file_summary: 特定のファイルの要約情報を設定または更新します。

4. ファイル監視

• toggle_file_watching: ファイルの自動監視機能をオンまたはオフに切り替えます。
• get_file_watching_status: 現在のファイル監視状態を確認します。
• update_file_watching_config: ファイル監視の関連設定パラメータを変更します。

5. チャート生成

• generate_diagram: 必要に応じて、異なるスタイルのチャートを生成し、テキストまたはHTML形式で出力できます。
• サポートされるチャートスタイルには、デフォルト、依存関係、ディレクトリ構造、または混合ビューが含まれます。
• 深さ制限、最小重要度閾値などのフィルタリングオプションを提供します。
• カスタムレイアウトパラメータを設定できます。

💻 使用例

プロジェクトの分析

1. ファイルツリー構成を作成します：

   create_file_tree(filename: "my-project.json", baseDirectory: "/path/to/project")
   

2. 最も重要な5つのファイルを検索します：

   find_important_files(limit: 5, minImportance: 5)
   

3. 特定のファイルの詳細情報を取得します：

   get_file_importance(filepath: "/path/to/project/src/main.ts")
   

ファイル要約の使用

1. ファイルの内容を読み取ります：

   read_file_content(filepath: "/path/to/project/src/main.ts")
   

2. ファイルの要約を追加します：

   set_file_summary(filepath: "/path/to/project/src/main.ts", summary: "主入口点，负责初始化应用程序、设置路由并启动服务器。")
   

3. ファイルの要約情報を取得します：

   get_file_summary(filepath: "/path/to/project/src/main.ts")
   

チャートの生成

1. プロジェクトの構造図を作成します：

   generate_diagram(style: "directory", maxDepth: 3, outputPath: "diagrams/project-structure", outputFormat: "mmd")
   

2. 依存関係を含むHTMLチャートを生成します：

   generate_diagram(style: "hybrid", maxDepth: 2, minImportance: 5, showDependencies: true, outputPath: "diagrams/important-files", outputFormat: "html")
   

3. レイアウトパラメータをカスタマイズします：

   generate_diagram(style: "dependency", layout: { direction: "LR", nodeSpacing: 50, rankSpacing: 70 }, outputPath: "diagrams/dependencies", outputFormat: "html")
   

ファイル監視

1. ファイルの自動監視を有効にします：

   toggle_file_watching(enabled: true)
   

2. 監視設定を更新します：

   update_file_watching_config(interval: 60, ignorePatterns: ["node_modules/**", "*.md"])
   

📚 ドキュメント

未来の改善方向

• より多くのプログラミング言語とファイルタイプをサポートする予定です。
• ファイル間の関係の可視化機能を追加します。
• 重要度に基づくコードスニペットの抽出機能を提供します。
• ファイル構造と依存関係をより直感的に表示するUIインターフェースを開発します。

📄 ライセンス

このプロジェクトはMITオープンソースライセンスに準拠しており、ユーザーは自由にコードを使用、変更、および配布することができます。