Добавить сервер
willianpinho/large-file-mcp
  1. Каталог MCP

willianpinho/large-file-mcp

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

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

🔗 Live Demo / Landing Page — install with npx @willianpinho/large-file-mcp

📚 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обязательный

    Абсолютный путь к файлу

get_file_summary

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

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

    Абсолютный путь к файлу

navigate_to_line

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

Параметры
  • contextLinesnumber

    Количество строк контекста до и после (по умолчанию: 5)

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

    Абсолютный путь к файлу

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

    Номер строки для перехода (отсчёт от 1)

read_large_file_chunk

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

Параметры
  • chunkIndexnumber

    Индекс фрагмента (отсчет от нуля) для чтения (по умолчанию: 0)

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

    Абсолютный путь к файлу

  • includeLineNumbersboolean

    Включает номера строк в вывод (по умолчанию: false)

  • linesPerChunknumber

    Количество строк на чанк (необязательно, определяется автоматически, если не указано)

search_in_large_file

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

Параметры
  • caseSensitiveboolean

    Поиск с учётом регистра (по умолчанию: false)

  • contextAfternumber

    Количество строк контекста после совпадения (по умолчанию: 2)

  • contextBeforenumber

    Количество строк контекста до совпадения (по умолчанию: 2)

  • endLinenumber

    Прекратить поиск на номере строки (необязательно)

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

    Абсолютный путь к файлу

  • maxResultsnumber

    Максимальное количество результатов (по умолчанию: 50)

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

    Шаблон поиска (поддерживает regex, если regex=true)

  • regexboolean

    Используйте regex-шаблон (по умолчанию: false)

  • startLinenumber

    Начать поиск с номера строки (необязательно)

stream_large_file

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

Параметры
  • chunkSizenumber

    Размер блока в байтах (по умолчанию: 65536 - 64 КБ)

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

    Абсолютный путь к файлу

  • maxBytesnumber

    Максимальное количество байтов для потоковой передачи (необязательно)

  • maxChunksnumber

    Максимальное количество возвращаемых чанков (по умолчанию: 10)

  • startOffsetnumber

    Начальное смещение в байтах (по умолчанию: 0)

1.1.1основная
1.1.0
1.0.0

Выберите клиент, чтобы установить willianpinho/large-file-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "willianpinho-large-file-mcp-gr5k299u79": {
      "command": "npx",
      "args": [
        "-y",
        "@willianpinho/large-file-mcp"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "willianpinho-large-file-mcp-gr5k299u79": {
      "command": "npx",
      "args": [
        "-y",
        "@willianpinho/large-file-mcp"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "willianpinho-large-file-mcp-gr5k299u79": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@willianpinho/large-file-mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"willianpinho-large-file-mcp-gr5k299u79\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@willianpinho/large-file-mcp\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "willianpinho-large-file-mcp-gr5k299u79": {
      "command": "npx",
      "args": [
        "-y",
        "@willianpinho/large-file-mcp"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add willianpinho-large-file-mcp-gr5k299u79 -- npx -y @willianpinho/large-file-mcp

Либо через JSON-конфиг:

claude mcp add-json willianpinho-large-file-mcp-gr5k299u79 "{\"command\":\"npx\",\"args\":[\"-y\",\"@willianpinho/large-file-mcp\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add willianpinho-large-file-mcp-gr5k299u79 -- npx -y @willianpinho/large-file-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.willianpinho-large-file-mcp-gr5k299u79]
command = "npx"
args = ["-y", "@willianpinho/large-file-mcp"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите willianpinho/large-file-mcp, а в поле команды запуска — строку ниже:
npx -y @willianpinho/large-file-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "willianpinho-large-file-mcp-gr5k299u79": {
      "command": "npx",
      "args": [
        "-y",
        "@willianpinho/large-file-mcp"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "willianpinho-large-file-mcp-gr5k299u79": {
      "command": "npx",
      "args": [
        "-y",
        "@willianpinho/large-file-mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например willianpinho-large-file-mcp-gr5k299u79.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: willianpinho-large-file-mcp-gr5k299u79
    command: npx
    args:
      - "-y"
      - "@willianpinho/large-file-mcp"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "willianpinho-large-file-mcp-gr5k299u79": {
      "command": "npx",
      "args": [
        "-y",
        "@willianpinho/large-file-mcp"
      ]
    }
  }
}

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

mamertofabian/mcp-everything-search

mamertofabian/mcp-everything-search

от mamertofabian

Кроссплатформенный MCP сервер для быстрого поиска файлов на Windows (Everything SDK), macOS (mdfind) и Linux (locate). Помогает разработчикам AI-ассистентов находить файлы по имени, пути и регулярн...

Python⭐ 366
efforthye/fast-filesystem-mcp

efforthye/fast-filesystem-mcp

от efforthye

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

TypeScript⭐ 64
exoticknight/mcp-file-merger

exoticknight/mcp-file-merger

от exoticknight

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

JavaScript⭐ 28
j0hanz/filesystem-context-mcp-server

j0hanz/filesystem-context-mcp-server

от j0hanz

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

TypeScript⭐ 25
tumf/mcp-text-editor

tumf/mcp-text-editor

от tumf

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

Python⭐ 202
mark3labs/mcp-filesystem-server

mark3labs/mcp-filesystem-server

от mark3labs

Работает с локальной файловой системой: читает, создаёт, перемещает файлы и каталоги, ищет текст по содержимому. Доступ только к разрешённым папкам.

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

Лука Никитин