🚀 MCP Server Chart - 完全离线版本

一个完全离线的 Model Context Protocol (MCP) 图表生成服务器，支持 15 种图表类型，无需网络连接即可生成高质量的 SVG 图表。

✨ 主要特性

• 🌐 完全离线 - 无需任何网络连接
• 📊 15种图表类型 - 涵盖基础图表、统计图表、高级图表和关系图表
• ⚡ 即时响应 - 平均生成时间 < 1ms
• 🪶 轻量级 - 纯 SVG 生成，无外部依赖
• 🔌 MCP 兼容 - 完全兼容 Model Context Protocol
• 🛡️ 数据安全 - 所有数据本地处理，不上传云端
• 🎨 高质量输出 - Base64 编码的 SVG data URL

📊 支持的图表类型

基础图表

• 📈 折线图 (line) - 显示数据趋势和变化
• 📊 柱状图 (bar/column) - 比较不同类别的数据
• 🥧 饼图 (pie) - 显示数据占比和分布
• 📈 面积图 (area) - 显示数据变化趋势和累积效果

统计图表

• 📊 直方图 (histogram) - 显示数据分布频率
• ⚪ 散点图 (scatter) - 显示两个变量之间的关系

高级图表

• ☁️ 词云图 (word-cloud) - 可视化文本数据的重要性
• 🎯 雷达图 (radar) - 多维数据对比分析
• 🗂️ 树状图 (treemap) - 层次化数据的面积展示
• 📊 双轴图 (dual-axes) - 同时展示两个不同量级的数据系列

关系图表

• 🧠 思维导图 (mind-map) - 展示概念之间的层次关系
• 🕸️ 网络图 (network-graph) - 显示节点和连接关系
• 🔄 流程图 (flow-diagram) - 展示步骤和流程
• 🐟 鱼骨图 (fishbone-diagram) - 因果关系分析图

🚀 快速开始

安装依赖

npm install

构建项目

npm run build

运行方式

1. MCP 服务器模式

# 默认 stdio 模式
node build/index.js

# SSE 模式（可通过 HTTP 访问）
node build/index.js --transport sse --port 1122

# Streamable 模式
node build/index.js --transport streamable --port 1122

2. 演示服务器模式

# 启动演示服务器
node demo-server.js

然后访问：

• 📊 演示页面: http://localhost:3000/demo
• 📚 API 文档: http://localhost:3000/api
• ❤️ 健康检查: http://localhost:3000/health

MCP 客户端配置

在您的 MCP 客户端配置文件中添加：

{
  "mcpServers": {
    "mcp-server-chart-offline": {
      "command": "node",
      "args": [
        "/path/to/mcp-server-chart/build/index.js"
      ],
      "cwd": "/path/to/mcp-server-chart"
    }
  }
}

📋 使用示例

基础图表

折线图

{
  "type": "line",
  "data": [
    { "time": 2020, "value": 100 },
    { "time": 2021, "value": 120 },
    { "time": 2022, "value": 150 },
    { "time": 2023, "value": 180 }
  ]
}

柱状图

{
  "type": "bar",
  "data": [
    { "category": "产品A", "value": 100 },
    { "category": "产品B", "value": 120 },
    { "category": "产品C", "value": 80 }
  ]
}

饼图

{
  "type": "pie",
  "data": [
    { "category": "苹果", "value": 40 },
    { "category": "橙子", "value": 30 },
    { "category": "香蕉", "value": 30 }
  ]
}

高级图表

词云图

{
  "type": "word-cloud",
  "data": [
    { "text": "JavaScript", "value": 50 },
    { "text": "Python", "value": 40 },
    { "text": "React", "value": 35 }
  ]
}

雷达图

{
  "type": "radar",
  "data": [
    { "category": "技能A", "value": 80 },
    { "category": "技能B", "value": 70 },
    { "category": "技能C", "value": 90 }
  ]
}

关系图表

流程图

{
  "type": "flow-diagram",
  "data": [
    { "name": "开始", "step": "start" },
    { "name": "处理", "step": "process" },
    { "name": "决策", "step": "decision" },
    { "name": "结束", "step": "end" }
  ]
}

🔧 API 接口

REST API

生成单个图表

POST /api/generate-chart
Content-Type: application/json

{
  "type": "line",
  "data": [{"time": 2020, "value": 100}],
  "width": 400,
  "height": 300
}

批量生成图表

POST /api/generate-charts
Content-Type: application/json

{
  "charts": [
    {"type": "line", "data": [...]},
    {"type": "bar", "data": [...]}
  ]
}

获取支持的图表类型

GET /api/chart-types

MCP 工具

项目提供以下 MCP 工具：

• generate_line_chart - 生成折线图
• generate_column_chart - 生成柱状图
• generate_area_chart - 生成面积图
• generate_pie_chart - 生成饼图
• generate_bar_chart - 生成条形图
• generate_histogram_chart - 生成直方图
• generate_scatter_chart - 生成散点图
• generate_word_cloud_chart - 生成词云图
• generate_radar_chart - 生成雷达图
• `generate_treemap_chart

... View full README on GitHub