金大哥 - mcp-file-context-server MCP 详情

article

README

🚀 文件上下文服务器

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

mcp-file-context-server