MCP File Context Server

🚀 文件上下文服務器

一個為大型語言模型（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。