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開源協議，允許用戶自由使用、修改和分發代碼。