File Context Server

基本能力

产品定位

File Context Server 是一个专为大型语言模型设计的文件系统上下文服务，提供文件操作、代码分析和高级搜索功能。

核心功能

• 文件操作：读取文件和目录内容，列出文件及其元数据，支持实时文件监控和缓存失效。
• 代码分析：计算代码的圈复杂度，提取依赖关系，分析注释，检测重复代码和长行等质量指标。
• 智能缓存：采用 LRU 缓存策略，支持自动缓存失效和配置缓存大小限制。
• 高级搜索：支持正则表达式匹配，上下文感知结果，文件类型过滤和多模式搜索。

适用场景

• 为 LLMs 提供文件系统上下文，增强其对代码的理解能力。
• 代码质量分析和维护。
• 高效的文件搜索和内容检索。

工具列表

1. list_context_files：列出目录中的文件及其元数据。
2. read_context：读取文件或目录内容及其元数据。
3. search_context：在文件中搜索模式并返回上下文。
4. analyze_code：分析代码文件的质量指标。
5. cache_stats：获取缓存统计信息和性能指标。

常见问题解答

• 错误处理：提供详细的错误消息和特定错误代码，如 FILE_NOT_FOUND、PERMISSION_DENIED 等。
• 配置：通过环境变量自定义缓存大小、文件大小限制等。

使用教程

使用依赖

无特殊依赖，只需安装 Node.js 和 npm。

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @bsmi021/mcp-file-context-server --client claude

手动安装

npm install @modelcontextprotocol/file-context-server

启动服务

npx file-context-server

调试方式

1. 开发模式

npm run dev

1. 运行测试

npm test

1. 构建项目

npm run build

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。