File Context Server

文件上下文服务器是一个模型上下文协议(MCP)服务器，让大型语言模型能够访问、搜索和分析文件系统中的代码和文本文件。

安装

npm install @modelcontextprotocol/file-context-server

启动服务器

npx file-context-server

核心功能

• 文件操作: 读取文件/目录、实时监控、多种编码支持
• 代码分析: 复杂度计算、依赖提取、质量指标
• 智能缓存: LRU策略、自动失效、性能统计
• 高级搜索: 正则匹配、上下文展示、类型过滤

主要工具使用

1. 列出文件

{
  "path": "./src",
  "recursive": true,
  "includeHidden": false
}

2. 读取文件内容

{
  "path": "./src/index.ts",
  "encoding": "utf8",
  "maxSize": 1000000
}

3. 搜索内容

{
  "pattern": "function.*",
  "path": "./src",
  "options": {
    "recursive": true,
    "contextLines": 2,
    "fileTypes": ["ts"]
  }
}

4. 分析代码

{
  "path": "./src",
  "recursive": true,
  "metrics": ["complexity", "dependencies", "quality"]
}

配置

主要环境变量：

• MAX_CACHE_SIZE: 缓存条目数 (默认: 1000)
• MAX_FILE_SIZE: 读取文件的最大字节数

错误处理

服务器返回详细错误，包括：FILE_NOT_FOUND、PERMISSION_DENIED、FILE_TOO_LARGE等。

开发

npm install   # 安装依赖
npm run build # 构建
npm test      # 测试
npm run dev   # 开发模式

许可证

MIT