文件上下文服务器

一个为大型语言模型（LLMs）提供文件系统上下文的 Model Context Protocol (MCP) 服务器。该服务器使 LLM 能够读取、搜索和分析代码文件，具备高级缓存和实时文件监控功能。

功能

• 文件操作

  • 读取文件和目录内容
  • 列出文件及其详细元数据
  • 实时文件监控与缓存失效
  • 支持多种文件编码
  • 递归遍历目录
  • 文件类型过滤

• 代码分析

  • 计算环状复杂度
  • 提取依赖关系
  • 分析注释内容
  • 质量指标：
    • 重复行检测
    • 长行检测（>100 字符）
    • 复杂函数识别
    • 行数统计（总数、非空行、注释行）

• 智能缓存

  • 最近最少使用（LRU）缓存策略
  • 文件更改时自动失效缓存
  • 带大小限制的缓存，支持配置上限
  • 缓存统计和性能指标
  • 最近读取结果缓存以优化搜索

• 高级搜索

  • 正则表达式匹配
  • 上下文感知结果，支持配置上下文行数
  • 文件类型过滤
  • 多模式搜索支持
  • 缓存结果搜索
  • 排除模式

安装

使用 Smithery 安装

通过 Smithery 自动安装 File Context Server for Claude Desktop：

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

手动安装

npm install @modelcontextprotocol/mcp-file-context

使用方法

启动服务器

node index.js

可用工具

• File Context Server: 提供文件系统上下文服务。
• Code Analysis Tools: 支持代码分析功能。

错误处理

• 错误代码：500
  • 描述：服务器内部错误
  • 解决方案：检查日志以获取更多信息
• 错误代码：404
  • 描述：资源未找到
  • 解决方案：确认请求路径是否正确

配置

{
  "cache": {
    "enabled": true,
    "maxSize": 1000
  },
  "monitoring": {
    "enabled": true,
    "interval": 60000
  }
}

开发指南

启动开发服务器

npm run dev

测试

npm test

许可证

MIT License

贡献指南

欢迎贡献！请参考 CONTRIBUTING.md。

注意： 有关跨平台路径兼容性，使用 path.posix.join 处理 glob 模式，并使用 path.normalize 访问文件系统。此更改避免了不同操作系统上的路径分隔符和文件匹配问题。