Largefile MCP Server

Get file structure, size, and semantic outline for large files (code, logs, data). Use FIRST when working with any file over 1000 lines or when you need to understand file structure. Returns: line count, byte size, binary detection, long line stats, section headings, and suggested search patterns. For code files, uses Tree-sitter to extract functions, classes, and structure. Does NOT return file content - use read_content or search_content for that.

Search large files for text patterns without loading entire content into memory. Use when finding functions, classes, errors, log entries, or counting occurrences. Supports: fuzzy matching (handles typos/whitespace), regex patterns, case-insensitive search, inverted matching (like grep -v), and count-only mode. Returns ranked matches with line numbers and context (lines truncated to 500 chars). When count_only=True, returns {count, pattern, fuzzy_enabled, regex_enabled, case_sensitive, inverted} instead of the full results structure.

Read specific portions of large files efficiently. Use after search_content locates content, or directly with tail/head modes for logs. Modes: 'lines' (read by offset/limit), 'semantic' (complete functions/classes via Tree-sitter), 'tail' (last N lines - ideal for logs), 'head' (first N lines). Does NOT search - use search_content first to find line numbers, then read_content to examine. For files over 500MB, tail/head modes are most efficient.

Find the enclosing function or class for a specific line number. Given a file and line number, returns the complete enclosing definition (function, method, class, struct, etc.) containing that line. Use depth=2 to get the parent definition (e.g., the class containing a method). Falls back to a centered context window for unsupported languages or top-level code.

Edit large files using search/replace with fuzzy matching. Use instead of line-based editing to avoid LLM line number errors. Fuzzy matching handles whitespace and formatting differences automatically. Preview mode (default) shows diff without applying. Creates automatic backup before changes - use revert_edit to undo. Does NOT support regex in replacement - patterns must be literal text (use fuzzy=true for flexibility).