🚀 文件上下文服务器
一个为大型语言模型（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。