BI-MCP-Server | BI图表MCP服务

一个基于Spring AI的MCP服务，支持22+种图表类型的生成。

样式：

目录

• 项目简介
• 功能特性
• 支持的图表类型
• 系统要求
• 快速开始
• 配置说明
• API参考
• 使用示例
• 项目结构
• 开发指南
• 测试数据
• 开源协议

项目简介

BI-MCP-Server 是一款基于 Spring Boot + Spring AI 实现的标准 MCP 服务端，专注后端原生图表生成，让 AI 具备开箱即用的数据可视化能力。

项目概述

BI-MCP-Server 是面向 AI 应用的 Model Context Protocol (MCP) 标准服务，基于 Spring Boot 与 Spring AI 构建。项目核心特色是纯 Java 后端渲染图表，不依赖 ECharts 等前端渲染引擎、无需浏览器环境，即可直接生成折线图、柱状图、饼图、雷达图等 22+ 种专业数据可视化图表，输出标准图片格式供业务直接使用。

通过标准化 MCP 协议，大模型可以自动发现工具、自动组装参数、自动调用图表能力，快速实现对话式 BI、自动报表生成、数据洞察可视化等场景。

核心特性

• 标准 MCP 协议兼容：遵循 Model Context Protocol 规范，AI 模型零改造接入，自动感知可用工具与入参
• 纯后端图表生成：基于 Java 原生绘图引擎，服务端直接出图，无前端依赖、无浏览器环境、无 JS 运行时
• 22+ 种图表类型覆盖：折线图、柱状图、饼图、散点图、面积图、直方图、环形图、雷达图、误差图等常用统计图表
• 开箱即用、轻量部署：基于 Spring Boot 构建，配置简单，可独立部署、接入微服务或嵌入现有数据平台
• 输出标准图片：支持生成 PNG 图片流 / 文件，可直接用于：自动报表、邮件推送、PDF/Excel 导出、监控大屏、消息通知等
• AI 友好型设计：入参结构化、接口统一、返回格式稳定，大模型可自动完成数据查询 → 图表生成 → 结果返回全流程

适用场景

• 🤖 AI 对话式数据分析与可视化
• 📊 后端自动化报表、日报 / 周报图表生成
• 📈 监控指标趋势图、统计分布图服务
• 🌐 无前端环境下的数据可视化需求
• 📄 PDF/Excel/ 邮件内嵌图表生成
• 🏢 企业内部 BI 平台、数据大屏图表服务

功能特性

• 22+种图表类型: 支持折线图、柱状图、饼图、雷达图、漏斗图、思维导图等
• Spring AI集成: 基于 Spring Boot 4.0.5 和 Spring AI 1.1.4 构建
• MCP协议: 标准化的 MCP 服务器实现，支持 Streamable HTTP 传输
• 易于集成: 可轻松集成到任何兼容 MCP 的 AI 应用中
• 灵活输出: 支持 PNG、JPEG 和 SVG 图片格式
• 可定制: 可配置尺寸、标题和输出格式
• 生产就绪: 为企业级 BI 应用而设计

支持的图表类型

系统要求

快速开始

1. 克隆仓库

git clone https://gitee.com/yulang_admin_1/bi-mcp-server.git
cd bi-mcp-server

2. 构建项目

mvn clean package -DskipTests

3. 启动服务

cd bi-mcp-server-api
mvn spring-boot:run

服务默认启动在 http://localhost:8080/mcp/stream/chart。

4. 连接MCP客户端

使用兼容的 MCP 客户端连接到：

http://localhost:8080/mcp/stream/chart

配置说明

应用配置 (application.yml)

server:
  port: ${SERVER_PORT:8080}

spring:
  ai:
    mcp:
      server:
        enabled: true
        name: bi-chart-mcp-server
        version: 1.0.0
        type: SYNC
        protocol: STREAMABLE
        streamable-http:
          endpoint: /mcp/stream/chart

chart:
  storage-dir: ${CHART_STORAGE_DIR:./charts}
  image-format: ${CHART_IMAGE_FORMAT:png}
  width: ${CHART_WIDTH:800}
  height: ${CHART_HEIGHT:600}

配置属性

API参考

MCP端点

• 地址: http://localhost:8080/mcp/stream/chart
• 协议: Streamable HTTP
• 传输: MCP协议

工具参数

使用示例

完整测试 数据： https://gitee.com/yulang_admin_1/bi-mcp-server/blob/master/test-data.md

生成折线图

输入数据:

[
  {"x": "1月", "y": 120},
  {"x": "2月", "y": 150},
  {"x": "3月", "y": 180},
  {"x": "4月", "y": 210}
]

工具调用:

{
  "tool": "generateLineChart",
  "arguments": {
    "data": "[{\"x\":\"1月\",\"y\":120},{\"x\":\"2月\",\"y\":150},{\"x\":\"3月\",\"y\":180},{\"x\":\"4月\",\"y\":210}]",
    "title": "月度销售趋势",
    "width": 800,
    "height": 600,
    "format": "png"
  }
}

响应:

{
  "success": true,
  "imageUrl": "http://localhost:8080/charts/line_chart_xxx.png",
  "message": "图表生成成功"
}

生成饼图

输入数据:

[
  {"name": "产品A", "value": 35},
  {"name": "产品B", "value": 25},
  {"name": "产品C", "value": 20},
  {"name": "产品D", "value": 20}
]

工具调用:

{
  "tool": "generatePieChart",
  "arguments": {
    "data": "[{\"name\":\"产品A\",\"value\":35},{\"name\":\"产品B\",\"value\":25},{\"name\":\"产品C\",\"value\":20},{\"name\":\"产品D\",\"value\":20}]",
    "title": "产品销售占比",
    "width": 800,
    "height": 600
  }
}

生成漏斗图

输入数据:

[
  {"name": "网站访问", "value": 10000},
  {"name": "浏览商品", "value": 6500},
  {"name": "加入购物车", "value": 3200},
  {"name": "提交订单", "value": 1800},
  {"name": "完成支付", "value": 1200}
]

工具调用:

{
  "tool": "generateFunnelChart",
  "arguments": {
    "data": "[{\"name\":\"网站访问\",\"value\":10000},{\"name\":\"浏览商品\",\"value\":6500},{\"name\":\"加入购物车\",\"value\":3200},{\"name\":\"提交订单\",\"value\":1800},{\"name\":\"完成支付\",\"value\":1200}]",
    "title": "电商转化漏斗",
    "width": 800,
    "height": 600
  }
}

项目结构

bi-mcp-server/
├── pom.xml                          # 父POM文件
├── README.md                        # 主 README（语言选择）
├── README-EN.md                     # 英文文档
├── README-ZH.md                     # 中文文档
├── test-data.md                     # 测试数据示例
├── bi-mcp-server-chart/             # 图表引擎模块
│   ├── pom.xml
│   └── src/main/java/com/bi/mcp/chart/
│       ├── config/
│       │   ├── ChartConfig.java     # 图表配置
│       │   └── ChartProperties.java # 图表属性
│       ├── engine/
│       │   ├── ChartEngine.java     # 图表渲染引擎
│       │   └── ChartValidator.java  # 数据验证
│       ├── model/
│       │   └── ChartType.java       # 图表类型枚举
│       ├── parser/
│       │   └── ChartDataParser.java # 数据解析工具
│       ├── service/
│       │   └── ChartMcpService.java # 包含22个工具的MCP服务
│       └── storage/
│           └── ChartStorageManager.java # 图表存储管理
└── bi-mcp-server-api/               # API模块
    ├── pom.xml
    └── src/main/java/com/bi/mcp/api/
        ├── BiMcpServerApplication.java # 应用入口
        └── config/
            └── ApiMcpServerConfig.java # MCP服务器配置

开发指南

添加新的图表类型

1. 在 ChartType.java 中添加新图表类型：

MY_NEW_CHART("我的新图表")

1. 在 ChartMcpService.java 中添加新方法：

@Tool(description = "生成新类型的图表...")
public String generateMyNewChart(
    @ToolParam(description = "数据数组") String data,
    @ToolParam(description = "图表标题", required = false) String title,
    ...
) {
    return generateChart(ChartType.MY_NEW_CHART, data, title, ...);
}

1. 更新图表引擎以处理新类型。

运行测试

mvn test

生产环境构建

mvn clean package -DskipTests
java -jar bi-mcp-server-api/target/bi-mcp-server-api-1.0.0.jar

测试数据

所有 22 种图表类型的详细测试数据和使用示例，请参考 test-data.md。

开源协议

本项目采用 MIT 开源协议 - 详见 LICENSE 文件。

作者

yulang