mcp · hushvert — MCP-сервер для Claude Code: что делает и как установить
Переводит офисные документы, PDF и видео через облачный API hushvert в окружении ИИ-агента. Пригодится, когда на рабочей машине нет LibreOffice или нужных конвертеров.
claude mcp add --env HUSHVERT_API_KEY=<HUSHVERT_API_KEY> --env HUSHVERT_ALLOWED_DIR=<HUSHVERT_ALLOWED_DIR> --transport stdio hushvert-mcp -- npx -y @hushvert/mcpЧто делает mcp
Сервер связывает ИИ-агента с облачным API hushvert через протокол MCP. Основной инструмент convert_file принимает путь к файлу и целевой формат, отправляет задачу в сервис и сохраняет готовый результат рядом с исходником. Для долгих операций, например перекодирования тяжёлого видео, предусмотрен опрос статуса через convert_poll по выданному jobId. Таймаут ожидания по умолчанию равен 120 секундам.
Пакет берёт на себя форматы, которые браузер обработать не может. Сюда входят офисные файлы DOCX и PPTX с экспортом в PDF, обратный перевод PDF в Word и перекодирование видео в MP4. Конвертировать картинки или аудиофайлы сервер отказывается. Для них автор советует клиентский движок @hushvert/engine.
Если в системе установлен LibreOffice, этот сервер вам не понадобится. Но на чистых машинах macOS, Windows или в контейнерах CI офисного пакета обычно нет. В таких случаях агенты зовут pandoc. Тот пересобирает документ через LaTeX и сбрасывает оформление со шрифтами. Для работы сервера требуется ключ HUSHVERT_API_KEY.
Какие задачи решает
- конвертировать файлы DOCX и PPTX в PDF с сохранением стилей
- преобразовывать документы PDF обратно в редактируемый формат DOCX
- перекодировать видеофайлы MKV или MOV в формат MP4
- собирать офисные документы в контейнерах CI без установки LibreOffice
Примеры запросов агенту
- Сконвертируй report.docx в PDF через hushvert
- Переведи презентацию slides.pptx в PDF и положи результат рядом
- Преобразуй видео archive.mkv в MP4
Как установить mcp
Командой платформы
claude mcp add --env HUSHVERT_API_KEY=<HUSHVERT_API_KEY> --env HUSHVERT_ALLOWED_DIR=<HUSHVERT_ALLOWED_DIR> --transport stdio hushvert-mcp -- npx -y @hushvert/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add hushvert-mcp --env HUSHVERT_API_KEY=<HUSHVERT_API_KEY> --env HUSHVERT_ALLOWED_DIR=<HUSHVERT_ALLOWED_DIR> -- npx -y @hushvert/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"hushvert-mcp": {
"command": "npx",
"args": [
"-y",
"@hushvert/mcp"
],
"env": {
"HUSHVERT_API_KEY": "<HUSHVERT_API_KEY>",
"HUSHVERT_ALLOWED_DIR": "<HUSHVERT_ALLOWED_DIR>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"hushvert-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hushvert/mcp"
],
"env": {
"HUSHVERT_API_KEY": "<HUSHVERT_API_KEY>",
"HUSHVERT_ALLOWED_DIR": "<HUSHVERT_ALLOWED_DIR>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e HUSHVERT_API_KEY=<HUSHVERT_API_KEY> -e HUSHVERT_ALLOWED_DIR=<HUSHVERT_ALLOWED_DIR> hushvert-mcp npx -y @hushvert/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp
Как установить mcp в Claude Code?
Выполните команду claude mcp add mcp -e HUSHVERT_API_KEY=<HUSHVERT_API_KEY> -- npx -y @hushvert/mcp в терминале. Вместо <HUSHVERT_API_KEY> укажите ваш секретный ключ hushvert.
Что делает сервер mcp?
Он даёт агенту инструмент convert_file для облачной конвертации офисных документов, PDF и видео через API hushvert. Результат записывается на диск рядом с исходным файлом.
Чем hushvert отличается от стандартной конвертации через pandoc?
Pandoc разбирает структуру документа и генерирует новый файл через LaTeX, теряя фирменные шрифты Word, цвета заголовков и оформление таблиц. Hushvert выполняет конвертацию через специализированный сервис и сохраняет исходное форматирование.
Похожие MCP-серверы
Все MCP-серверы по теме «Документы и офис» →Сначала — mcp от других авторов.
