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` для недоверенных клиентов и не упаковывайте папки с секретами.
Настройка клиентов
{
"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 для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.