quario — MCP-сервер для Claude Code: установка и работа
Проверяет JSON-описание отчёта и сохраняет его в PDF, Excel, Word, HTML или CSV. Подходит для генерации файлов из данных через MCP-клиент.
claude mcp add --env QUARIO_LICENSE=<QUARIO_LICENSE> --env QUARIO_DATA_ROOT=<QUARIO_DATA_ROOT> --env QUARIO_OUT_DIR=<QUARIO_OUT_DIR> --env QUARIO_LOCALE=<QUARIO_LOCALE> --env QUARIO_CURRENCY=<QUARIO_CURRENCY> --transport stdio quario -- npx -y @quario/mcpЧто делает quario
quario добавляет два инструмента MCP: validate_report проверяет описание отчёта, а render_report создаёт файл. Одно JSON-описание можно вывести в pdf, xlsx, docx, html или csv. При ошибке сервер указывает путь проблемного поля, чтобы агент мог исправить описание и повторить проверку.
Сервер работает локально через stdio и запускается командой npx -y @quario/mcp. Результат рендеринга возвращается как путь к файлу и его размер, а не как содержимое файла. Существующее имя не перезаписывается: к нему добавляется суффикс -1, затем -2.
Для запуска нужен Node 22 или новее. Лицензия QUARIO_LICENSE убирает отметку о лицензии из результата; без ключа сервер запускается, но каждый отчёт получает такую отметку. Путь к данным и каталог вывода задаются переменными QUARIO_DATA_ROOT и QUARIO_OUT_DIR, а лимиты запросов и разрешённые схемы ссылок берутся из окружения. Без Node 22 сервер не запустится.
Какие задачи решает
- проверить JSON-описание отчёта до рендеринга
- собрать PDF из данных и структуры отчёта
- вывести один отчёт в Excel, Word, HTML или CSV
- найти ошибочное поле по пути в JSON
- сохранить результат в заданный каталог
Примеры запросов агенту
- Проверь описание отчёта и укажи проблемы во всех целевых форматах.
- Собери PDF из данных заказов и сохрани результат с именем
orders. - Преобразуй это JSON-описание в
xlsx,docxиhtml, верни пути к файлам.
Как установить quario
Командой платформы
claude mcp add --env QUARIO_LICENSE=<QUARIO_LICENSE> --env QUARIO_DATA_ROOT=<QUARIO_DATA_ROOT> --env QUARIO_OUT_DIR=<QUARIO_OUT_DIR> --env QUARIO_LOCALE=<QUARIO_LOCALE> --env QUARIO_CURRENCY=<QUARIO_CURRENCY> --transport stdio quario -- npx -y @quario/mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add quario --env QUARIO_LICENSE=<QUARIO_LICENSE> --env QUARIO_DATA_ROOT=<QUARIO_DATA_ROOT> --env QUARIO_OUT_DIR=<QUARIO_OUT_DIR> --env QUARIO_LOCALE=<QUARIO_LOCALE> --env QUARIO_CURRENCY=<QUARIO_CURRENCY> -- npx -y @quario/mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"quario": {
"command": "npx",
"args": [
"-y",
"@quario/mcp"
],
"env": {
"QUARIO_LICENSE": "<QUARIO_LICENSE>",
"QUARIO_DATA_ROOT": "<QUARIO_DATA_ROOT>",
"QUARIO_OUT_DIR": "<QUARIO_OUT_DIR>",
"QUARIO_LOCALE": "<QUARIO_LOCALE>",
"QUARIO_CURRENCY": "<QUARIO_CURRENCY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"quario": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@quario/mcp"
],
"env": {
"QUARIO_LICENSE": "<QUARIO_LICENSE>",
"QUARIO_DATA_ROOT": "<QUARIO_DATA_ROOT>",
"QUARIO_OUT_DIR": "<QUARIO_OUT_DIR>",
"QUARIO_LOCALE": "<QUARIO_LOCALE>",
"QUARIO_CURRENCY": "<QUARIO_CURRENCY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e QUARIO_LICENSE=<QUARIO_LICENSE> -e QUARIO_DATA_ROOT=<QUARIO_DATA_ROOT> -e QUARIO_OUT_DIR=<QUARIO_OUT_DIR> -e QUARIO_LOCALE=<QUARIO_LOCALE> -e QUARIO_CURRENCY=<QUARIO_CURRENCY> quario npx -y @quario/mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о quario
Как установить quario в Claude Code?
Выполните claude mcp add mcp -e QUARIO_LICENSE=<QUARIO_LICENSE> -- npx -y @quario/mcp, затем перезапустите Claude Code.
Что делает quario?
Сервер проверяет JSON-описания отчётов и рендерит их в PDF, Excel, Word, HTML или CSV. Агент получает путь к созданному файлу, а не его байты.
Нужен ли ключ лицензии для работы quario?
Сервер запускается без ключа, но каждый результат получает отметку о нелицензированном рендеринге. Ключ передаётся через QUARIO_LICENSE.
