How willianpinho/large-file-mcp works
Large File MCP Server exposes large-file operations as MCP tools over stdio. An AI client requests chunk reads, line navigation, search, structure or summary analysis, or byte streaming; the server dispatches requests through the FileHandler API to specialized file-processing modules. Metadata checks and file-type-based chunk sizing support those operations, while the server caches chunks and structure results. The README documents all six capabilities; source excerpts show dispatch and most implementations, but not every server handler or external-client integration in full.
Main entry points: metadata.ts File metadata · fileHandler.ts FileHandler API · types.ts Shared types · server.ts MCP server
Components 13
MCP interface
- CLI entry
src/index.ts - MCP server
src/server.ts - MCP SDK
File operations
- FileHandler API
src/fileHandler.ts - Chunk navigation
src/file-handler/reader.ts - Context search
src/file-handler/search.ts - Structure analysis
src/file-handler/analysis.ts - Byte streaming
src/file-handler/stream.ts
Caching
- LRU cache
src/cacheManager.ts
Shared foundations
- File metadata
src/file-handler/metadata.ts - Shared types
src/types.ts
Other components
- AI client
- Local files
Connections 25
- AI client → MCP server: invokes tools
src/server.ts - CLI entry → MCP server: starts
src/index.ts - MCP server → MCP SDK: connects over stdio
src/server.ts - MCP server → FileHandler API: dispatches file calls
src/server.ts - MCP server → LRU cache: reads and writes
src/server.ts - FileHandler API → File metadata: delegates metadata
src/fileHandler.ts - FileHandler API → Chunk navigation: delegates reads
src/fileHandler.ts - FileHandler API → Context search: delegates searches
src/fileHandler.ts - FileHandler API → Structure analysis: delegates analysis
src/fileHandler.ts - FileHandler API → Byte streaming: delegates streaming
src/fileHandler.ts - Chunk navigation → File metadata: gets file metadata
src/file-handler/reader.ts - Context search → File metadata: verifies file
src/file-handler/search.ts - Structure analysis → File metadata: gets metadata and sizing
src/file-handler/analysis.ts - Byte streaming → File metadata: verifies file
src/file-handler/stream.ts - File metadata → Local files: checks and reads
src/file-handler/metadata.ts - Chunk navigation → Local files: reads lines
src/file-handler/reader.ts - Context search → Local files: scans lines
src/file-handler/search.ts - Structure analysis → Local files: scans content
src/file-handler/analysis.ts - Byte streaming → Local files: streams bytes
src/file-handler/stream.ts - LRU cache → Shared types: uses cache types
src/cacheManager.ts - File metadata → Shared types: uses file types
src/file-handler/metadata.ts - Chunk navigation → Shared types: uses chunk types
src/file-handler/reader.ts - Context search → Shared types: uses search types
src/file-handler/search.ts - Structure analysis → Shared types: uses analysis types
src/file-handler/analysis.ts - Byte streaming → Shared types: uses stream types
src/file-handler/stream.ts