API ВЕГА
English

Графики RegiaBI: MCP-сервер и плагин для агентов

Код графиков, который с первого раза подходит вашим данным и остаётся у вас: вы платите за его создание, но не за использование.

В этом репозитории собраны MCP-сервер для графиков RegiaBI (com.regiabi/chart-mcp, опубликованный в npm как

@bicharts/chart-mcp) и навык для агента. Вместе они образуют плагин, который устанавливается одной командой в Claude Code, GitHub Copilot CLI, Codex и Gemini CLI. В репозитории находятся манифесты плагина, зафиксированная команда запуска сервера и навык. Сам сервер распространяется как npm-пакет.

Что делает сервер

Передайте своему агенту для программирования таблицу — CSV-файл, фрейм данных или результат запроса к семантической модели — и получите готовый интерактивный код графика, подходящий для этих данных:

  • Анализирует данные локально. Сервер определяет количество строк, число уникальных значений, меры и измерения, даты и географические объекты. На этом этапе данные не покидают ваш компьютер.

  • Ранжирует около 90 типов графиков с учётом того, что действительно можно показать по этим данным. Для этого используется серверный механизм проверки применимости, а не предположения: карта предлагается, только если в данных есть географические объекты, а диаграмма Sankey — только если есть потоки.

  • Возвращает проверенный исходный код, который принадлежит вам: D3 для проектов на JavaScript и TypeScript, Plotly или matplotlib для Python. Код уже прошёл проверку рендеринга. Для его запуска, развёртывания и публикации не нужны лицензия, учётная запись или подключение к нашему сервису — независимо от числа зрителей.

Инструменты:

ИнструментНазначение
assess_data_shapeЛокально анализирует таблицу. Бесплатно и без учётной записи.
list_eligible_chartsВозвращает полный список подходящих для этих данных типов графиков, ранжированный с учётом языка проекта.
suggest_chartsДля Microsoft Fabric App с семантической моделью определяет естественные представления модели и подходящие для каждого из них графики — за один вызов.
generate_chartСоздаёт график: записывает в ваш проект код, данные и настройки подключения для @bicharts/chart-host (с открытым исходным кодом).

Установка

Claude Code

/plugin marketplace add codexguy/regiabi-plugins
/plugin install regiabi-charts@regiabi

GitHub Copilot CLI

copilot plugin marketplace add codexguy/regiabi-plugins
copilot plugin install regiabi-charts@regiabi

Codex

codex plugin marketplace add codexguy/regiabi-plugins

Затем установите RegiaBI charts из Plugins Directory.

Gemini CLI

gemini extensions install https://github.com/codexguy/regiabi-plugins

Любой другой MCP-клиент

VS Code, Cursor, Claude Desktop и любой другой MCP-клиент могут запускать сервер напрямую:

{
  "mcpServers": {
    "bic-chart": {
      "command": "npx",
      "args": ["-y", "@bicharts/chart-mcp"]
    }
  }
}

Настройка

Обычно настраивать ничего не нужно. Для создания графика требуется учётная запись RegiaBI; для запуска уже созданного графика она не нужна.

Войдите в учётную запись, когда появится запрос. При первом вызове агентом инструмента, которому нужна учётная запись, сервер откроет браузер на сайте bizintelligencechampions.com. Войдите в учётную запись или создайте бесплатную — в неё включён бесплатный пробный период — и нажмите «Разрешить». После этого вызов инструмента, сделанный агентом, завершится автоматически. Сервер сохраняет данные входа в ~/.bic/oauth.json и самостоятельно обновляет их. Выйти из учётной записи на конкретном устройстве можно в любое время на странице учётной записи.

Или используйте лицензионный ключ — например, на компьютере без браузера, в CI или контейнере. Не выполняйте вход, а передайте серверу данные учётной записи одним из двух способов:

  • Когда плагин запросит их (Claude Code запрашивает данные при установке и сохраняет ключ в защищённом системном хранилище учётных данных) или через переменные окружения сервера: BIC_LICENSEE и BIC_LICENSE_KEY, а также BIC_SECRET_KEY, если он используется в вашей учётной записи.

  • Через файл с учётными данными, чтобы секреты не попадали в конфигурацию проекта, добавляемую в систему контроля версий. Создайте файл ~/.bic/credentials.json (или укажите другой путь в BIC_CREDENTIALS_FILE):

{ "licensee": "...", "licenseKey": "..." }

Если задан ключ, он всегда имеет приоритет над входом в учётную запись. Чтобы войти вместо этого, оставьте поля плагина пустыми.

Использование

В нужном проекте попросите агента обычными словами создать нужный график. Например:

Проанализируй структуру данных в ./sales.csv, расскажи, какие графики подойдут, и создай лучший вариант в ./charts.

Агент проанализирует файл, запросит у сервера список подходящих типов графиков и запишет код графика и данные в ./charts. После этого график можно импортировать. Навык, который устанавливается вместе с плагином, поможет агенту выполнить остальные шаги: настройка перекрёстной фильтрации между графиками, их размеров и оформления относится к библиотеке-хосту, поэтому агент не будет создавать её самостоятельно.

Создаёте Microsoft Fabric App? Возьмите шаблон приложения для работы с данными от Rayfin, а затем спросите агента, какие графики подойдут для вашей семантической модели. Инструмент suggest_charts сформирует ответ на основе данных самой модели.

Какие данные сервер использует, отправляет и загружает

  • При входе в учётную запись браузер один раз открывается на сайте bizintelligencechampions.com. Затем сервер сохраняет токен доступа и токен обновления в ~/.bic/oauth.json (файл доступен только вам) и отправляет токен доступа в каждом запросе к сервису.

  • Сервер запускает один локальный процесс: npx -y @bicharts/chart-mcp@ — именно ту версию, на которую указывает плагин. При первом запуске npm загружает пакет из публичного реестра npm.

  • Инструмент assess_data_shape ничего не отправляет. Он анализирует данные на вашем компьютере.

  • Инструменты list_eligible_charts, suggest_charts и generate_chart обращаются к сервису RegiaBI на сайте bizintelligencechampions.com, передавая данные вашей учётной записи и профиль таблицы: названия столбцов, типы данных, количество значений и сводную статистику. По умолчанию строки не отправляются; с помощью аргумента privacy_level можно отправить меньше данных (только названия) или больше (обезличенные примеры строк). Инструмент suggest_charts запрашивает семантическую модель через собственный CLI fabric-app-data проекта Fabric App, используя вашу учётную запись, и отправляет сервису профиль того же типа.

  • Сервер записывает сгенерированный код графика и данные в указанную вами папку и никуда больше.

  • Телеметрия: одна запись создаётся при передаче кода инструментом generate_chart — в неё входят длительность вызова, количество строк, язык и сборка сервера. Ещё одна запись создаётся, если генерация завершается ошибкой после ответа сервиса. Данные и счётчик использования не отправляются: сервис учитывает вызовы по полученным запросам. Чтобы отключить обе записи, задайте в окружении сервера BIC_MCP_TELEMETRY=0.

  • При входе в учётную запись отправляется имя этого компьютера (его hostname). Благодаря этому устройство отображается на странице учётной записи, и для него можно отдельно завершить сеанс.

  • Инструмент check_app запрашивает в реестре npm сведения о последних версиях пакетов, используемых приложением (параметр check_npm: false отключает эту проверку). Файл preview.html при открытии загружает d3 и mermaid с cdn.jsdelivr.net. Он создаётся только при указании preview_html: true.

Дополнительная информация

Поддержка и условия использования