VS-QA

Просмотровщик логов с поддержкой AI-анализа через MCP.

Установка

Через Homebrew (macOS)

brew tap VladislavSumin/vs-qa
brew install vs-qa

После установки:

vs-qa [path_to_log_file] [path_to_mapping_file]

Обновление:

brew update && brew upgrade vs-qa

Вручную

• Скачать vs-qa.jar из последнего релиза. (На данный момент поддерживается только macos)
• Запустить командой java -jar vs-qa.jar [path_to_log_file] [path_to_mapping_file]

AI-анализ логов (MCP)

VS-QA умеет работать как MCP-сервер — AI-ассистент может самостоятельно открывать логи, фильтровать и искать в них ошибки.

Подключение к OpenCode

Добавьте в конфиг проекта opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "vs_qa": {
      "type": "local",
      "command": [
        "vs-qa",
        "--mcp-server"
      ],
      "enabled": true,
      "timeout": 15000
    }
  },
  "agent": {
    "explore": {
      "permission": {
        "vs_qa_*": "allow"
      }
    }
  }
}

После перезапуска OpenCode агент получит инструменты open_log, query_log, get_log_info, close_log и сможет анализировать логи напрямую.

Локальная сборка

Для локальной сборки проекта необходимо скачать репозиторий vs-core на один уровень файловой системы с этим репозиторием. После этого дополнительных действий не требуется.

• Собрать jar файл - ./gradlew :app:jvm:buildFatJarMain.
• Собрать минимизированный jar файл - ./gradlew :app:jvm:buildFatJarMainMin.
• Запустить ./gradlew :app:jvm:jvmRun [--args "<path_to_log_file> [path_to_mapping_file]"].