File Context Server
2025.03.24
0
JavaScript文件管理代码分析开发工具开发效率
File Context Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在为大型语言模型 (LLMs) 提供文件系统上下文。该服务支持文件的读取、搜索和分析，具备高级缓存和实时文件监控能力。
View on GitHub
Overview
基本能力
产品定位
File Context Server 是一个为大型语言模型提供文件系统上下文的服务，支持文件的读取、搜索和分析，具备高级缓存和实时文件监控能力。
核心功能
- 文件操作
- 读取文件和目录内容
- 列出文件及其详细元数据
- 实时文件监控和缓存失效
- 支持多种文件编码
- 递归目录遍历
-
文件类型过滤
-
代码分析
- 计算圈复杂度
- 提取依赖关系
- 分析注释
-
质量指标检测（如重复行、长行、复杂函数等）
-
智能缓存
- LRU 缓存策略
- 文件变更时自动缓存失效
- 可配置的缓存大小限制
-
缓存统计和性能指标
-
高级搜索
- 正则表达式匹配
- 上下文感知结果
- 文件类型过滤
- 多模式搜索支持
适用场景
- 代码库的静态分析和质量检查
- 文件内容的快速搜索和检索
- 开发环境中的文件监控和缓存管理
工具列表
- list_context_files：列出目录中的文件及其元数据
- read_context：读取文件或目录内容及其元数据
- search_context：在文件中搜索模式并返回上下文
- analyze_code：分析代码文件的质量指标
- cache_stats：获取缓存统计和性能指标
常见问题解答
- 错误处理：提供详细的错误消息和特定错误代码（如
FILE_NOT_FOUND、PERMISSION_DENIED等） - 配置：通过环境变量自定义缓存大小、文件大小限制等
使用教程
使用依赖
确保已安装 Node.js 和 npm。
安装教程
npm install @modelcontextprotocol/file-context-server
启动服务
npx file-context-server
调试方式
- 开发模式
npm run dev
- 运行测试
npm test
- 构建项目
npm run build