# densely

Упаковывает большие логи, JSON и дампы в 2–8 раз меньше токенов. Разворачивает обратно байт в байт, с проверкой sha256.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Автор: alibaizhanov
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/alibaizhanov/densely
- Обновлён: 2026-08-13
- HTML: https://affpapa.org/nevibecode/mcp/densely

## Что делает

densely берёт текст, прогоняет его через lzma и режет на 16-битные куски, которые раскладывает по английским словам-носителям. Каждое такое слово стоит ровно один токен, поэтому в полезной нагрузке помещается два байта сжатых данных. Есть и нейронный режим: целочисленный арифметический кодер берёт вероятности следующего токена у Qwen2.5-Coder-0.5B.

Агенту доступны три инструмента. `compress_file(path)` вызывается вместо чтения крупного лога или JSON и отдаёт превью вместе с плотной нагрузкой. `compress_text(text)` делает то же самое с уже полученным выводом инструмента. `expand(payload | payload_file, start_line, end_line)` возвращает исходник, сверяя хеш; диапазон строк нужен, чтобы платить только за нужный кусок. Рядом с оригиналом остаётся sidecar-файл `.dense` — обычный текст, который можно закоммитить или отправить в архив.

Ставится через `pip install "densely[mcp]"`, нейронный бэкенд требует extras `[neural]` с torch и transformers. Для автоматического режима есть хук PostToolUse: он сжимает вывод Bash и чтение не-кода от 5000 токенов, порог меняется переменной `DENSELY_HOOK_MIN_TOKENS`. В `~/.claude/settings.json` путь к `densely-hook` указывайте абсолютный, потому что хуки выполняются вне вашего `PATH`. Файлы кода, которые агент редактирует, хук не трогает.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add densely -- uvx densely
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from densely <команда>

### Codex

**Командой платформы**
```bash
codex mcp add densely -- uvx densely
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from densely <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "densely": {
            "command": "uvx",
            "args": [
                "densely"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from densely <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "densely": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "densely"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from densely <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add densely uvx densely
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from densely <команда>

## Когда брать
- уложить большой лог в контекст без потери строк
- вернуть исходный JSON из сжатой нагрузки байт в байт
- достать из payload только нужный диапазон строк
- сжимать вывод Bash автоматически, не вызывая инструмент вручную
- посчитать, сколько токенов сэкономила сессия

## Примеры запросов агенту
- Сожми `install.log` и покажи превью, читать его целиком не надо
- Разверни из `payload.dense` строки с 200 по 260
- Сколько токенов мы сэкономили за сессию?

## Похожие
- [Context Engine](https://affpapa.org/nevibecode/mcp/context-engine.md) — MCP-сервер · ★ 326
- [Sophon](https://affpapa.org/nevibecode/mcp/sophon.md) — MCP-сервер · ★ 9
- [context-compression](https://affpapa.org/nevibecode/skills/context-compression.md) — скилл · 1400 установок
- [toon-format](https://affpapa.org/nevibecode/skills/toon-format.md) — скилл · 1300 установок
- [omni-compression](https://affpapa.org/nevibecode/skills/omni-compression.md) — скилл · 1000 установок
- [cli-compression](https://affpapa.org/nevibecode/skills/cli-compression.md) — скилл · 976 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md