Filescopemcp

🚀 MCP（多言語コンポーネントプロトコル）サーバードキュメント

このドキュメントは、プロジェクトファイルを分析し、ダイアグラムを生成するためのMCP（多言語コンポーネントプロトコル）サーバーに関するものです。以下に、その機能と使用方法を説明します。

📦 ファイルツリー管理ツール

• list_saved_trees：保存されているすべてのファイルツリーをリスト表示します。
• create_file_tree：特定のディレクトリに対して新しいファイルツリー構成を作成します。
• select_file_tree：操作対象として既存のファイルツリーを選択します。
• delete_file_tree：ファイルツリー構成を削除します。

📂 ファイル分析ツール

• list_files：プロジェクト内のすべてのファイルとその重要度ランキングをリスト表示します。
• get_file_importance：特定のファイルの詳細情報（依存関係や関連ファイルを含む）を取得します。
• find_important_files：設定可能な基準に基づいて、プロジェクト内の最も重要なファイルを検索します。
• read_file_content：特定のファイルの内容を読み取ります。
• recalculate_importance：ファイルの依存関係に基づいて、すべてのファイルの重要度を再計算します。

📝 ファイル要約ツール

• get_file_summary：特定のファイルの保存要約を取得します。
• set_file_summary：特定のファイルの要約を設定または更新します。

👀 ファイル監視ツール

• toggle_file_watching：ファイル監視機能を有効または無効にします。
• get_file_watching_status：現在のファイル監視状態を取得します。
• update_file_watching_config：ファイル監視設定を更新します。

📊 ダイアグラム生成ツール

• generate_diagram：カスタムオプションに基づいてダイアグラムを生成します。
  • 出力形式：Mermaidテキスト（.mmd）またはHTML埋め込みレンダリング。
  • ダイアグラムスタイル：デフォルト、依存関係、ディレクトリ、または混合ビュー。
  • フィルタオプション：最大深度、最低重要度閾値。
  • レイアウトオプション：方向（TB、BT、LR、RL）、ノード間隔、ランク間隔。

💻 使用例

基本的な使用法

プロジェクトの分析

1. プロジェクトのファイルツリーを作成します。

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

2. 最も重要なファイルを見つけます。

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: "TB", nodeSpacing: 20, rankSpacing: 15 }, outputPath: "diagrams/custom-layout", outputFormat: "html")

🔮 将来の改善点

• より多くのプログラミング言語への対応を拡充します。
• ユーザーが拡大縮小やパン操作を行えるインタラクティブなダイアグラム機能を提供します。
• ダイアグラムを複数の形式（PNG、SVGなど）にエクスポートできるようにします。

📄 ライセンス

このプロジェクトのコードと関連リソースは、MITライセンスの下で提供されています。詳細については、プロジェクトのルートディレクトリにあるLICENSEファイルを参照してください。