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")

🔧 技術細節

文檔未提及技術實現細節，故跳過。

📄 許可證

本項目的代碼和相關資源受 MIT 許可證的約束。詳細內容請參考項目根目錄下的 LICENSE 文件。