Quick Chart 图表工具服务

解决什么问题

当你想把一段数据变成图表时，通常要写一段前端代码，或者手动打开 Quick Chart 的网站粘贴配置。这个技能把这件事压缩成一句自然语言：告诉大模型你要什么图，它负责把参数翻译成 Quick Chart API 的 JSON，调完再把图片链接返回给你。适合在对话式环境里快速出图，而不必自己维护一套渲染逻辑。

核心能力与工作流程

它是一个基于 Model Context Protocol（MCP）的服务器，只做一件事：把用户的绘图意图转成 Quick Chart 请求，再取回图表图片链接。暴露的工具只有一个：

• scripts.tools.GetChartImgLink：根据参数绘制图表并返回图片链接，参数语法遵循 Quick Chart API（quickchart.io）。

其中唯一的参数 json 是可选的 JSON 对象，用于描述图表，里面只允许放值，不允许放函数。

模型在这里承担路由层的角色，流程分为几步：

1. 检查 API 密钥：读取 scripts.config.settings.api_key，为空时通过 AskUserQuestion 向用户索要，拿到后调用 scripts.config.set_api_key(api_key) 保存；
2. 选择工具：按用户意图选定 GetChartImgLink；
3. 提取参数：从对话中解析图表描述，参数不完整时继续追问；
4. 调用工具：以关键字参数方式调用，例如 scripts.tools.GetChartImgLink(json=...)；
5. 返回结果：工具返回 dict，包含 result["raw"]（API 原始 JSON）、result["success"]（是否成功）与 result["message"]（状态消息），整理后展示给用户。

适用边界与注意点

• API 密钥是硬性前提。.env 中没有 XBY_APIKEY 时技能无法工作，规范明确禁止在缺密钥的情况下自行搜索或编造数据。
• 密钥需通过官方站点注册获取，属于前置准备工作。
• 服务器只负责“生成链接”，不做图表托管、缓存或状态管理，链接可用性由 Quick Chart 服务端决定。
• 参数语法完全对齐 quickchart.io；由于 json 中不允许包含函数，依赖脚本的深度定制超出其表达范围。