mcp-file-context-server

Overview

This MCP server enables LLMs to read, search, and analyze code files with comprehensive file operations and code analysis tools. It implements advanced caching with LRU strategy and real-time file watching capabilities. The server offers multiple tools for listing files, reading contents, searching patterns, analyzing code quality metrics, and managing cache statistics, making it particularly valuable for code review and understanding large codebases.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list_context_files({ path: string, recursive?: boolean, includeHidden?: boolean }) => Promise<{files: Array}>

  Lists files in a directory with detailed metadata

  Try:List all files in the src directoryTry:Show all TypeScript files in the project recursively
• read_context({ path: string, encoding?: string, maxSize?: number, recursive?: boolean, fileTypes?: string[] }) => Promise<{content: string, metadata: Object}>

  Reads file or directory contents with metadata

  Try:Read the content of index.tsTry:Read all JavaScript files in the src directory
• search_context({ pattern: string, path: string, options?: { recursive?: boolean, contextLines?: number, fileTypes?: string[] } }) => Promise<{matches: Array}>

  Searches for patterns in files with context

  Try:Search for all function definitions in the codebaseTry:Find all TODO comments with context
• analyze_code({ path: string, recursive?: boolean, metrics?: string[] }) => Promise<{analysis: Object}>

  Analyzes code files for quality metrics

  Try:Analyze code complexity in the src directoryTry:Check for dependencies in the project
• cache_stats({ detailed?: boolean }) => Promise<{stats: Object}>

  Gets cache statistics and performance metrics

  Try:Show cache statisticsTry:Get detailed performance metrics for the cache

Comparable tools

Installation

npx -y @smithery/cli install @bsmi021/mcp-file-context-server --client claude

npm install @modelcontextprotocol/file-context-server

{
  "mcpServers": {
    "file-context": {
      "command": "npx",
      "args": ["file-context-server"]
    }
  }
}

FAQ

What file types are supported?

The server supports multiple file encodings and can filter by file type. Common code files like TypeScript, JavaScript are supported, with the ability to specify custom file types.

How does caching work?

The server uses an LRU (Least Recently Used) caching strategy with automatic cache invalidation when files change. Cache size and TTL can be configured via environment variables.

Compare mcp-file-context-server with