RegiaBI charts

RegiaBI charts：MCP 服务与 Agent 插件

让图表和地图生成式 AI 更出色。

适用于 Power BI、Excel、Fabric 应用和 Web 的 AI 数据组件：包含双变量地图及其双向图例、控件嵌入图表内的假设分析预测，以及约 90 种常用图表类型，并已接入选择和交叉筛选。代码归你所有：你只需为创建图表付费，无需为运行图表付费。

此代码仓库将 RegiaBI 图表 MCP 服务（com.regiabi/chart-mcp，在 npm 上以 @bicharts/chart-mcp 发布）及其 Agent 技能打包为一条命令即可安装的插件，适用于 Claude Code、GitHub Copilot CLI、Codex 和 Gemini CLI。仓库包含插件清单、固定版本的服务命令和技能。服务本身是 npm 包。

功能介绍

向你的编码 Agent 提供一张表（CSV、数据框或来自语义模型的查询结果），它就会返回适合该数据的可用交互式图表代码：

• **在本地分析数据。**统计行数、基数、度量与维度、日期和地点。此步骤不会将数据发送出你的设备。
• **根据数据能够如实呈现的内容，为约 90 种图表类型排序，**采用服务端资格判定引擎，而非猜测，因此只有存在可绘制地点时才会提供地图，只有存在流向时才会提供桑基图。
• **返回经过验证且归你所有的源代码：**JavaScript 和 TypeScript 项目使用 D3，Python 项目使用 Plotly 或 matplotlib。代码已通过渲染检查。运行、部署或发布代码无需许可证、账号或连接我们的服务，观看人数不限。

工具：

工具	用途
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

然后从 Plugins Directory 安装 RegiaBI charts。

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 账号；运行已生成的图表则无需任何配置。

**按提示登录。**Agent 首次调用需要账号的工具时，服务会在浏览器中打开 bizintelligencechampions.com。登录或创建免费账号（账号附带免费试用），然后点击 Allow。Agent 发起的调用随后会自动完成。服务会将登录信息保存在 ~/.bic/oauth.json 中，并自动续期；你随时可以在账号页面注销某台设备。

或使用许可证密钥（适用于没有浏览器的设备、CI 和容器）。不使用登录功能，改为向服务提供账号凭据，可通过以下两种方式之一完成：

• 在插件提示时提供（Claude Code 会在安装时提示输入，并将密钥保存在系统的安全凭据存储中），或将环境变量设置在服务上：BIC_LICENSEE 和 BIC_LICENSE_KEY；如果账号使用了 BIC_SECRET_KEY，也需设置。

• 使用凭据文件，避免任何密钥出现在项目已提交的配置中。将以下内容放入 ~/.bic/credentials.json（或将 BIC_CREDENTIALS_FILE 指向其他路径）：

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

设置密钥后，密钥始终优先于登录。若要改为登录，请将插件中的字段留空。

使用

用自然语言告诉 Agent 你想要什么图表，以及要把它放在哪个项目中。例如：

评估 ./sales.csv 的形状，告诉我哪些图表适合它，然后把最佳图表生成到 ./charts。

Agent 会分析文件，询问服务端适合哪些图表类型，然后将图表代码和数据写入 ./charts，以便导入。此插件安装的技能会引导 Agent 完成其余工作：图表间的交叉筛选、尺寸设置和主题由宿主库负责，因此 Agent 不会编写这些内容。

正在构建 Microsoft Fabric App？ 使用 Rayfin 的数据应用模板搭建应用，然后询问 Agent 哪些图表适合你的语义模型。suggest_charts 会根据模型自身的数据给出回答。

它运行、发送和获取的内容

• 登录时会打开浏览器并访问 bizintelligencechampions.com 一次；随后服务端会将访问令牌和刷新令牌保存在 ~/.bic/oauth.json（只有你能读取），并在每次调用服务时发送访问令牌。
• 它会运行一个本地进程：npx -y @bicharts/chart-mcp@<version>，即插件固定使用的确切版本。npm 首次运行时会从公共 npm 注册表下载该软件包。
• assess_data_shape 不会发送任何内容。 它会在你的计算机上分析数据。
• list_eligible_charts、suggest_charts 和 generate_chart 会调用 RegiaBI 服务 bizintelligencechampions.com，并发送你的账户凭据及表格概况：列名、类型、计数和汇总统计信息。默认情况下不会发送任何行；privacy_level 参数可以减少发送内容（仅发送名称），也可以增加发送内容（经过混淆的样本行）。suggest_charts 会通过 Fabric App 项目自己的 fabric-app-data CLI 查询你的语义模型，以你的身份登录，并向服务发送相同类型的概况。
• 它会将生成的图表代码和数据写入你指定的文件夹，不会写入其他位置。
• 遥测：generate_chart 交付代码时会发送一条记录（调用耗时、行数、语言和服务端构建版本），服务作出响应后生成失败时也会发送一条记录。不会发送数据，也不会记录使用次数：服务会根据收到的请求统计调用次数。在服务端环境中设置 BIC_MCP_TELEMETRY=0，即可关闭这两条记录。
• 登录时会发送此计算机的名称（其主机名），这样登录记录会显示在你的账户页面上，你可以单独将该计算机登出。
• check_app 会向 npm 注册表查询你的应用所用软件包的最新版本（设置 check_npm: false 可跳过）；打开 preview.html 时会从 cdn.jsdelivr.net 加载 d3 和 mermaid（只有传入 preview_html: true 时才会写入该文件）。

了解更多

• 面向开发者的 RegiaBI：文档、示例和在线演示
• npm 上的 @bicharts/chart-mcp：所有工具的参数和结果
• @bicharts/chart-host：运行图表的开源库
• MCP 官方注册表条目

支持与条款

• 支持
• 服务端及其调用的服务受 RegiaBI 程序化访问条款和隐私政策约束。服务端自身的许可证随其 npm 软件包一同提供。
• 此仓库中的文件（插件清单、README 和技能）依据 LICENSE 中的 MIT 许可证发布。它们不包含服务端源代码。