🚀 文件上下文服务器

一个为大型语言模型（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

💡 使用建议

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

🤝 贡献指南

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