File Context Server

Features

• **File Operations** - Read file and directory contents - List files with detailed metadata - Real-time file watching and cache invalidation - Support for multiple file encodings - Recursive directory traversal - File type filtering

• **Code Analysis** - Cyclomatic complexity calculation - Dependency extraction - Comment analysis - Quality metrics: - Duplicate lines detection - Long lines detection (>100 characters) - Complex function identification - Line counts (total, non-empty, comments)

• **Smart Caching** - LRU (Least Recently Used) caching strategy - Automatic cache invalidation on file changes - Size-aware caching with configurable limits - Cache statistics and performance metrics - Last read result caching for efficient searches

• **Advanced Search** - Regex pattern matching - Context-aware results with configurable surrounding lines - File type filtering - Multi-pattern search support - Cached result searching - Exclusion patterns

Installation

Installing via Smithery

Manual Installation

Usage

Starting the Server

Available Tools

1. **list_context_files** - Lists files in a directory with detailed metadata ```json { "path": "./src", "recursive": true, "includeHidden": false } ```

2. **read_context** - Reads file or directory contents with metadata ```json { "path": "./src/index.ts", "encoding": "utf8", "maxSize": 1000000, "recursive": true, "fileTypes": ["ts", "js"] } ```

3. **search_context** - Searches for patterns in files with context ```json { "pattern": "function.*", "path": "./src", "options": { "recursive": true, "contextLines": 2, "fileTypes": ["ts"] } } ```

4. **analyze_code** - Analyzes code files for quality metrics ```json { "path": "./src", "recursive": true, "metrics": ["complexity", "dependencies", "quality"] } ```

5. **cache_stats** - Gets cache statistics and performance metrics ```json { "detailed": true } ```

Error Handling

• `FILE_NOT_FOUND`: File or directory does not exist

• `PERMISSION_DENIED`: Access permission issues

• `INVALID_PATH`: Invalid file path format

• `FILE_TOO_LARGE`: File exceeds size limit

• `ENCODING_ERROR`: File encoding issues

• `UNKNOWN_ERROR`: Unexpected errors

Configuration

• `MAX_CACHE_SIZE`: Maximum number of cached entries (default: 1000)

• `CACHE_TTL`: Cache time-to-live in milliseconds (default: 1 hour)

• `MAX_FILE_SIZE`: Maximum file size in bytes for reading

Development

License

Contributing

Cross-Platform Path Compatibility

• All glob patterns use POSIX-style paths (forward slashes) internally, ensuring consistent file matching regardless of OS.

• All file system operations (reading, writing, stat, etc.) use normalized absolute paths for reliability.

• If you are developing or extending the server, use `path.posix.join` for glob patterns and `path.normalize` for file system access.

• This change prevents issues with path separators and file matching on different operating systems.