文件作用域

简介

此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开源协议，允许用户自由使用、修改和分发代码。