Kompressr — MCP-сервер для Claude Code: загрузка и оптимизация файлов
MCP-сервер для загрузки файлов, ожидания обработки и выдачи приватных ссылок прямо из агента. Пригодится, когда агенту нужно отдать картинку или видео наружу.
claude mcp add --env KOMPRESSR_API_KEY=<KOMPRESSR_API_KEY> --env KOMPRESSR_PROJECT_ID=<KOMPRESSR_PROJECT_ID> --transport stdio mcp-server -- npx -y @kompressr/mcp-serverЧто делает Kompressr
Kompressr даёт агенту набор инструментов для работы с файлами: upload_asset принимает ровно один file_path или file_url, wait_for_asset ждёт обработки, generate_private_url выдаёт свежую ссылку с истечением срока. Есть ещё list_assets с постраничным выводом, get_asset_status и delete_asset для безвозвратного удаления по явному ID.
Серверу нужен Node.js 22 или новее. В конфигурации задаются KOMPRESSR_API_KEY и, если планируете листать загрузки, KOMPRESSR_PROJECT_ID. Без ключа проект не поднимется, а list_assets без UUID проекта просто не заработает — это повод проверить окружение до первого запуска. Ключи лучше держать на доверенной машине и не коммитить в репозиторий.
Обратите внимание на разделение статусов: обработка и удаление — разные состояния. Приватная ссылка истекает, но сам файл при этом не удаляется. Удаление запускает фоновую очистку, отменить его нельзя, а кэши и скачанные копии могут остаться. Если wait_for_asset вышел по таймауту, повторно загружать файл не нужно — сохраните asset_id и продолжите с ним.
Какие задачи решает
- загрузить файл в хранилище прямо из агента
- дождаться обработки видео и не гадать о готовности
- выдать клиенту временную приватную ссылку на файл
- найти нужную загрузку по статусу или external_id
- удалить конкретные ассеты пачкой по списку ID
Примеры запросов агенту
- Загрузи
preview.pngчерез Kompressr и дождись обработки - Сделай приватную ссылку на ассет 4821 на час
- Покажи мои загрузки со статусом failed на второй странице
Как установить Kompressr
Командой платформы
claude mcp add --env KOMPRESSR_API_KEY=<KOMPRESSR_API_KEY> --env KOMPRESSR_PROJECT_ID=<KOMPRESSR_PROJECT_ID> --transport stdio mcp-server -- npx -y @kompressr/mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp-server --env KOMPRESSR_API_KEY=<KOMPRESSR_API_KEY> --env KOMPRESSR_PROJECT_ID=<KOMPRESSR_PROJECT_ID> -- npx -y @kompressr/mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@kompressr/mcp-server"
],
"env": {
"KOMPRESSR_API_KEY": "<KOMPRESSR_API_KEY>",
"KOMPRESSR_PROJECT_ID": "<KOMPRESSR_PROJECT_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kompressr/mcp-server"
],
"env": {
"KOMPRESSR_API_KEY": "<KOMPRESSR_API_KEY>",
"KOMPRESSR_PROJECT_ID": "<KOMPRESSR_PROJECT_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e KOMPRESSR_API_KEY=<KOMPRESSR_API_KEY> -e KOMPRESSR_PROJECT_ID=<KOMPRESSR_PROJECT_ID> mcp-server npx -y @kompressr/mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Kompressr
Как установить Kompressr в Claude Code?
Выполните claude mcp add kompressr -e KOMPRESSR_API_KEY=<KOMPRESSR_API_KEY> -- npx -y @kompressr/mcp-server. Если нужен доступ к списку загрузок, добавьте переменную KOMPRESSR_PROJECT_ID.
Что делает Kompressr?
Даёт агенту инструменты для загрузки файлов, ожидания обработки, выдачи приватных ссылок и удаления ассетов по ID. Работа с файлами идёт через отдельный пакет @kompressr/sdk.
Что нужно для работы Kompressr?
Node.js 22 или новее и ключ KOMPRESSR_API_KEY из дашборда проекта. Для list_assets понадобится ещё UUID проекта в KOMPRESSR_PROJECT_ID.
