文件等级 MCP（模型上下文协议）服务器

一种基于 TypeScript 的工具，用于按重要性对代码库中的文件进行排序，并提供带有依赖关系跟踪的摘要。

概述

此工具可帮助您跟踪项目中哪些文件最重要，并为其提供 0（最不重要）到 10（最重要）之间的评级。它还可以跟踪文件依赖关系并提供摘要，帮助您了解代码库结构。

特征

• 按 0-10 的等级对文件进行排序（10 为最重要）
• 跟踪并可视化文件依赖关系（哪些文件导入哪些文件）
• 实时文件系统监控，实现自动更新
• 获取文件摘要（带有 LLM 集成的占位符）
• 查询单个文件、目录或整个代码库的排名
• 具有发现端点的自文档 API
• 简单的 stdio JSON 接口

设置

1. 克隆此存储库
2. 使构建脚本可执行：
   chmod +x build.sh
3. 运行构建脚本：
   ./build.sh
   这将：
   • 检查 Node.js 安装
   • 安装项目依赖项
   • 编译 TypeScript 代码
   • 生成 MCP 配置
   • 在/tmp/file-rank-mcp_*.log中创建详细的日志文件
4. 将生成的mcp.json移动到项目的.cursor/目录以便与 Cursor AI 一起使用

用法

该工具使用模型上下文协议 (MCP) 通过 stdio 上的 JSON 进行通信。它会自动监视项目目录的更改，并相应地更新文件树。

运行服务器

支持的语言

服务器自动检测以下语言的依赖关系：

• Python： import和from ... import语句
• C/C++： #include指令
• Rust： use和mod语句
• Lua： require语句
• JavaScript/TypeScript： import语句

工作原理

该工具会维护代码库的实时树形结构，并存储在file-tree.json中。每当项目目录中检测到更改时，此文件都会自动更新。

数据结构

文件树以 JSON 结构存储：

依赖性检测

该工具分析源代码以检测依赖关系：

• 扫描文件内容以查找特定于语言的导入模式
• 将相对导入解析为绝对路径
• 验证导入的文件是否存在
• 根据依赖计数计算重要性

文件重要性计算

文件根据以下因素分配重要性分数（0-10）：

• 依赖项的数量（导入此文件的文件）
• 依赖树中的位置
• 文件类型和位置

技术堆栈

• TypeScript/Node.js
• 模型上下文协议 SDK (v1.7.0)
• Chokidar 用于文件系统监控
• 以 CommonJS 模块为目标的 ES2020

发展

要修改或扩展项目：

1. 更改src目录中的 TypeScript 文件
2. 运行构建脚本来编译并更新配置：
   ./build.sh
3. 运行服务器：
   node dist/mcp-server.js

构建脚本将：

• 安装任何新的依赖项
• 编译 TypeScript 代码
• 生成更新的 MCP 配置
• 创建详细的日志文件以进行故障排除

与法学硕士 (LLM) 的整合

当前实现包含 LLM 集成的占位符。在生产环境中，服务器可以扩展为：

• 使用 LLM 生成文件摘要
• 分析代码复杂度和可维护性
• 提供文件整理的智能建议
• 根据代码结构生成文档

执照

本项目遵循 GNU 通用公共许可证 v3 (GPL-3.0)。完整许可证文本请参阅LICENSE文件。