使用说明

项目简介

QuickChart Server 是一个基于 Model Context Protocol (MCP) 的服务器，它扩展了大型语言模型 (LLM) 的能力，使其能够生成各种图表。该服务器利用 QuickChart.io 的在线图表生成服务，通过 MCP 协议向客户端提供图表生成工具。

主要功能点

图表生成工具 ('generate_chart'): 根据用户提供的图表配置，生成 QuickChart.io 的图表 URL。支持多种图表类型，包括柱状图、折线图、饼图、甜甜圈图、雷达图、极坐标图、散点图、气泡图、径向仪表盘和速度计图。
图表下载工具 ('download_chart'): 允许用户将生成的图表图片下载到本地文件系统。

安装步骤

安装 Smithery CLI (如果尚未安装):

npm install -g @smithery/cli

使用 Smithery 安装 QuickChart Server:

npx -y @smithery/cli install @GongRzhe/Quickchart-MCP-Server --client claude

这个命令会自动下载并安装 QuickChart Server。

服务器配置

要将 QuickChart Server 集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的 MCP 服务器设置。以下是 Claude Desktop 的配置示例，您需要将配置信息添加到 Claude Desktop 的配置文件中。

配置文件路径:

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

配置内容 (JSON):

{
  "mcpServers": {
    "quickchart-server": {
      "command": "node",
      "args": ["/path/to/quickchart-server/build/index.js"]
      // 请将 "/path/to/quickchart-server" 替换为 QuickChart Server 实际的安装路径
      // 例如: "/Users/yourusername/.smithery/servers/@GongRzhe/Quickchart-MCP-Server/current/build/index.js" (MacOS)
      //      "C:\\Users\\YourUsername\\AppData\\Roaming\\smithery\\servers\\@GongRzhe\\Quickchart-MCP-Server\\current\\build\\index.js" (Windows)
    }
  }
}

注意: 'args' 字段中的路径需要指向 'Quickchart-MCP-Server' 安装目录下的 'build/index.js' 文件。Smithery 会将服务器安装在用户目录下的 '.smithery' 文件夹中，具体的路径会根据操作系统和 Smithery 版本有所不同。您可以使用 Smithery 的 'info' 命令来查找服务器的安装路径。

基本使用方法

配置完成后，MCP 客户端应该能够检测到 QuickChart Server 提供的工具。您可以通过客户端的界面或指令来调用 'generate_chart' 和 'download_chart' 工具，并根据工具的输入参数要求提供图表配置信息。

例如，要使用 'generate_chart' 工具生成一个柱状图，您需要提供如下参数：

{
  "type": "bar",
  "data": {
    "labels": ["A", "B", "C"],
    "datasets": [{
      "label": "数据",
      "data": [10, 20, 15]
    }]
  }
}

工具会返回一个包含图表 URL 的文本内容。您可以将此 URL 复制到浏览器中查看生成的图表。

要使用 'download_chart' 工具下载图表，您需要提供图表配置以及希望保存图表的本地路径。

关键词