# mcp

Переводит офисные документы, PDF и видео через облачный API hushvert в окружении ИИ-агента. Пригодится, когда на рабочей машине нет LibreOffice или нужных конвертеров.

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

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `HUSHVERT_API_KEY`, `HUSHVERT_ALLOWED_DIR` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
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

**Командой платформы**
```bash
codex mcp add hushvert-mcp --env HUSHVERT_API_KEY=<HUSHVERT_API_KEY> --env HUSHVERT_ALLOWED_DIR=<HUSHVERT_ALLOWED_DIR> -- npx -y @hushvert/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hushvert-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@hushvert/mcp"
            ],
            "env": {
                "HUSHVERT_API_KEY": "<HUSHVERT_API_KEY>",
                "HUSHVERT_ALLOWED_DIR": "<HUSHVERT_ALLOWED_DIR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
gemini mcp add -e HUSHVERT_API_KEY=<HUSHVERT_API_KEY> -e HUSHVERT_ALLOWED_DIR=<HUSHVERT_ALLOWED_DIR> hushvert-mcp npx -y @hushvert/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- конвертировать файлы DOCX и PPTX в PDF с сохранением стилей
- преобразовывать документы PDF обратно в редактируемый формат DOCX
- перекодировать видеофайлы MKV или MOV в формат MP4
- собирать офисные документы в контейнерах CI без установки LibreOffice

## Примеры запросов агенту
- Сконвертируй report.docx в PDF через hushvert
- Переведи презентацию slides.pptx в PDF и положи результат рядом
- Преобразуй видео archive.mkv в MP4

## Похожие
- [Excel MCP Server](https://affpapa.org/nevibecode/mcp/excel-mcp-server.md) — MCP-сервер · ★ 4268
- [kordoc](https://affpapa.org/nevibecode/mcp/kordoc.md) — MCP-сервер · ★ 2795
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP-сервер · ★ 1248
- [Microsoft 365 MCP Server](https://affpapa.org/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP-сервер · ★ 1085
- [anymd](https://affpapa.org/nevibecode/mcp/anymd.md) — MCP-сервер · ★ 1054
- [Docling MCP](https://affpapa.org/nevibecode/mcp/docling-mcp.md) — MCP-сервер · ★ 779

## Другие версии с тем же именем
- [mcp · kubeshark](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

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