willianpinho/large-file-mcp

willianpinho/large-file-mcp

от willianpinho
MCP сервер для умной обработки больших файлов: автоматический чанкинг, поиск по регулярным выражениям, навигация по строкам и стриминг. Пригодится разработчикам и аналитикам при работе с логами, кодом и данными.

Large File MCP Server

MCP server for intelligent handling of large files — smart chunking, search, navigation, and streaming.

npm version npm downloads CI codecov License: MIT TypeScript Node.js MCP Documentation GitHub stars GitHub issues

Large File MCP Server

📚 Full Documentation | API Reference | Examples

Features

  • Smart Chunking - Automatically determines optimal chunk size based on file type
  • Intelligent Navigation - Jump to specific lines with surrounding context
  • Powerful Search - Regex support with context lines before/after matches
  • File Analysis - Comprehensive metadata and statistical analysis
  • Memory Efficient - Stream files of any size without loading into memory
  • Performance Optimized - Built-in LRU caching for frequently accessed chunks
  • Type Safe - Written in TypeScript with strict typing
  • Cross-Platform - Works on Windows, macOS, and Linux

Installation

npm install -g @willianpinho/large-file-mcp

Or use directly with npx:

npx @willianpinho/large-file-mcp

Quick Start

Claude Code CLI

Add the MCP server using the CLI:

# Add for current project only (local scope)
claude mcp add --transport stdio --scope local large-file-mcp -- npx -y @willianpinho/large-file-mcp

# Add globally for all projects (user scope)
claude mcp add --transport stdio --scope user large-file-mcp -- npx -y @willianpinho/large-file-mcp
Инструменты были проиндексированы:
get_file_structure

Анализирует структуру файла и получает всесторонние метаданные, включая статистику строк, рекомендуемый размер чанка и образцы из начала и конца.

Параметры
  • filePathstringобязательный

    Absolute path to the file

get_file_summary

Получает полную статистическую сводку файла, включая статистику строк, символов и количество слов.

Параметры
  • filePathstringобязательный

    Absolute path to the file

navigate_to_line

Переходит к указанной строке в большом файле с окружающими строками контекста. Выделяет целевую строку.

Параметры
  • contextLinesnumber

    Number of context lines before and after (default: 5)

  • filePathstringобязательный

    Absolute path to the file

  • lineNumbernumberобязательный

    Line number to navigate to (1-indexed)

read_large_file_chunk

Читает определенный фрагмент крупного файла с интеллектуальной разбивкой на фрагменты на основе типа файла. Автоматически определяет оптимальный размер фрагмента.

Параметры
  • chunkIndexnumber

    Zero-based chunk index to read (default: 0)

  • filePathstringобязательный

    Absolute path to the file

  • includeLineNumbersboolean

    Include line numbers in output (default: false)

  • linesPerChunknumber

    Number of lines per chunk (optional, auto-detected if not provided)

search_in_large_file

Ищет шаблон в большом файле с контекстными строками. Поддерживает регулярные выражения и поиск с учётом регистра.

Параметры
  • caseSensitiveboolean

    Case sensitive search (default: false)

  • contextAfternumber

    Number of context lines after match (default: 2)

  • contextBeforenumber

    Number of context lines before match (default: 2)

  • endLinenumber

    End searching at line number (optional)

  • filePathstringобязательный

    Absolute path to the file

  • maxResultsnumber

    Maximum number of results (default: 100)

  • patternstringобязательный

    Search pattern (supports regex if regex=true)

  • regexboolean

    Use regex pattern (default: false)

  • startLinenumber

    Start searching from line number (optional)

stream_large_file

Потоково передаёт большой файл по частям. Возвращает несколько частей для эффективной обработки очень больших файлов.

Параметры
  • chunkSizenumber

    Chunk size in bytes (default: 65536 - 64KB)

  • filePathstringобязательный

    Absolute path to the file

  • maxBytesnumber

    Maximum bytes to stream (optional)

  • maxChunksnumber

    Maximum number of chunks to return (default: 10)

  • startOffsetnumber

    Starting byte offset (default: 0)

Похожие MCP-сервера

exoticknight/mcp-file-merger

exoticknight/mcp-file-merger

MCP-сервер для быстрого объединения нескольких файлов в один. Удобен разработчикам, которым нужно сливать текстовые файлы или фрагменты кода в один документ. Работает только с разрешёнными директор...

JavaScript27
mark3labs/mcp-filesystem-server

mark3labs/mcp-filesystem-server

MCP-сервер для безопасного доступа к локальной файловой системе. Операции: чтение, запись, копирование, а также удаление и поиск. Работает только с разрешёнными директориями. Поддерживает проверку ...

Go687
tumf/mcp-text-editor

tumf/mcp-text-editor

MCP сервер для построчного редактирования текстовых файлов с частичным доступом снижает расход токенов при работе с LLM. Поддерживает безопасное редактирование через хэш-валидацию и работу с разным...

Python199
efforthye/fast-filesystem-mcp

efforthye/fast-filesystem-mcp

MCP инструмент для файловой системы через Claude Desktop. Поддерживает чтение и запись больших файлов, пакетное редактирование с резервированием, поиск по содержимому. Полезен для автоматизации файловых операций.

TypeScript61
ahonn/mcp-server-gsc

ahonn/mcp-server-gsc

MCP сервер для работы с Google Search Console: получает до 25 000 строк поисковых данных, фильтрует по регулярным выражениям, автоматически находит Quick Wins. Полезен SEO-специалистам и разработчикам для углубленного анализа производительности сайта.

TypeScript263
jordandalton/restcsv-mcp-server

jordandalton/restcsv-mcp-server

Сервер для работы с CSV-данными через REST API: с ним AI-агенты (Claude, Cursor) могут читать, записывать и управлять таблицами как удалёнными ресурсами. Полезен для автоматизации аналитики и интеграции данных без загрузки файлов.

TypeScript12
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин