Repomix

Repomix — MCP-сервер сообщества (автор — yamadashy). Repomix упаковывает локальный или удалённый репозиторий в удобный для LLM файл. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
yamadashy
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: high

Без `--sandbox` читает любые файлы пользователя и доверяет `repomix.config.*` в упаковываемой папке (конфиг — это код). Включайте `--sandbox` для недоверенных клиентов и не упаковывайте папки с секретами.

Настройка клиентов

vscode
{
    "code": "code --add-mcp '{\"name\":\"repomix\",\"command\":\"npx\",\"args\":[\"-y\",\"repomix\",\"--mcp\"]}'",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Repomix упаковывает весь репозиторий в один файл, удобный для ИИ, и умеет работать как MCP-сервер. В режиме MCP ассистент сам упаковывает локальную папку или удалённый репозиторий GitHub, а потом читает результат по частям и ищет в нём. Не нужно вручную собирать файлы и копировать их в чат.

  • pack_codebase упаковывает локальную папку в один XML-файл. Можно фильтровать файлы по шаблонам и включить сжатие через Tree-sitter: остаются сигнатуры и структура кода, а расход токенов по README падает примерно на 70%.
  • pack_remote_repository скачивает и упаковывает репозиторий GitHub по ссылке или в формате user/repo, в том числе конкретную ветку.
  • attach_packed_output подключает уже готовый файл упаковки без повторной обработки.
  • read_repomix_output читает результат целиком или диапазоном строк.
  • grep_repomix_output ищет в результате по регулярному выражению с контекстом до и после совпадения.
  • file_system_read_file и file_system_read_directory читают файлы и папки, но только в режиме песочницы.

Каждая упаковка показывает метрики и список самых больших файлов.

Кому подойдёт

  • Разработчику, который разбирается в чужом коде: ассистент получит весь проект целиком и объяснит архитектуру.
  • Тем, кто делает код-ревью и рефакторинг: поиск по упакованному коду и сжатие для больших проектов.
  • Тем, кто изучает открытые проекты: упаковка любого репозитория GitHub по ссылке.

Другие варианты — в категории разработка и в подборке MCP для GitHub.

Установка

Сервер запускается через npx, установка не нужна:

npx -y repomix --mcp

Есть и Docker-образ ghcr.io/yamadashy/repomix с тем же флагом --mcp. Для Claude Code также доступны официальные плагины Repomix.

Режим песочницы

По умолчанию сервер читает любые пути, доступные вашему пользователю. Флаг --sandbox ограничивает его одной папкой:

repomix --mcp --sandbox path/to/project

В этом режиме отклоняются абсолютные пути, ~, .. и ссылки за пределы папки.

Подключение к клиентам

Команды приведены дословно из README. Общий порядок — в инструкции как подключить MCP.

claude mcp add repomix -- npx -y repomix --mcp

Для Cursor и Claude Desktop README советует конфиг, аналогичный конфигу Cline:

{
  "mcpServers": {
    "repomix": {
      "command": "npx",
      "args": [
        "-y",
        "repomix",
        "--mcp"
      ]
    }
  }
}

Проверка

Попросите ассистента упаковать текущий проект и показать пять самых больших файлов. Он вызовет pack_codebase и вернёт метрики.

Инструменты

Инструмент Что делает Доступ
pack_codebase Упаковка локальной папки чтение
pack_remote_repository Упаковка репозитория GitHub чтение
attach_packed_output Подключение готовой упаковки чтение
read_repomix_output Чтение результата чтение
grep_repomix_output Поиск в результате чтение

Примеры задач

Упакуй репозиторий yamadashy/repomix со сжатием и объясни, как устроена его архитектура.
Упакуй папку src без тестов и найди все места, где читаются переменные окружения.
Сравни, как обрабатываются ошибки в двух модулях проекта.

Риски

Без --sandbox сервер читает любые файлы, доступные пользователю, а упакованный код попадает в контекст модели. README предупреждает: без песочницы pack_codebase загружает и доверяет файлу repomix.config.* в упаковываемой папке, а конфиг — это код, который может выполниться. pack_remote_repository клонирует внешние репозитории.

Как снизить риски: включайте --sandbox, если клиент или агент не полностью доверенный, не упаковывайте папки с секретами и чужие проекты с непроверенным конфигом. В режиме песочницы содержимое, похожее на известные форматы секретов, не выдаётся. Лицензия — MIT.

Частые вопросы

Сколько токенов экономит сжатие?

По README сжатие через Tree-sitter сокращает расход токенов примерно на 70%, сохраняя сигнатуры и структуру кода.

Можно ли упаковать чужой репозиторий?

Да, pack_remote_repository принимает ссылку на GitHub или формат user/repo, в том числе с веткой.

Как ограничить доступ к файлам?

Запускайте сервер с флагом --sandbox: он ограничит работу одной папкой.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • pack_codebase
  • pack_remote_repository
  • attach_packed_output
  • read_repomix_output
  • grep_repomix_output

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

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники