安装
uvx --from charted[mcp] charted-mcp适合谁
你希望智能体直接出 SVG 或 PNG 图，而且不想先把 charted 写进项目依赖。官方 MCP 路径用 uvx 在一次性环境里拉起带 MCP extra 的 charted，经 stdio 提供服务。核心库零运行时依赖；PNG 导出和 MCP 是可选 extra，会自带依赖，底座仍是纯 Python。
它适合先问有哪些图表类型和主题，再决定是否生成。官方写明 15 种图表类型。第一次不要走未展开的 pip 安装说明。
官方仓库单独一行：
https://github.com/marzukia/charted
工具细节锚点单独一行：
https://github.com/marzukia/charted#mcp-server-ai-agent-integration
3 分钟完成第一次尝试
只走这一条 uvx 命令：
uvx --from charted[mcp] charted-mcp
Claude Code 的注册方式是：
claude mcp add charted -- uvx --from charted[mcp] charted-mcp
Cursor、Cline 以及其他客户端则把同一条命令写进各自的 MCP 配置。不要并行再装一套项目内虚拟环境作为主路径。
前置条件：本机有 uvx。uvx 会拉取 charted 的 MCP extra 到一次性环境。
配置位置：Claude Code 用上面的 add；其他客户端的 MCP server 配置里填同一 uvx 命令，stdio 启动。
低风险第一步：调用 list_chart_types，列出图表类型。或调用 list_themes 列出主题。两者都是清单，不生成文件。成功信号是返回类型或主题列表。不要把清单理解成无网络：uvx 仍会取包并启动本机进程。
若列表正常，再考虑出图。create_chart 会生成图表；chart_from_csv 从 CSV 出图。出图会在代理侧产生 SVG 或 PNG，不是只读。调用前确认数据可以交给这个一次性环境；调用后以得到图表为成功信号。官方未写输出落盘路径，也没有撤销命令。
使用案例
案例一：先看支持哪些类型。调用 list_chart_types。需要主题时再调用 list_themes。官方只给出工具名，没有枚举 15 种类型的名单。
案例二：用结构化数据或 CSV 出图。调用 create_chart 生成图表，或调用 chart_from_csv 从 CSV 生成。输出可以是 SVG 或 PNG。PNG 与 MCP 一样属于 opt-in extra。官方未给出字段名、主题名或 CSV 列约定。
使用边界
主路径是 uvx --from charted[mcp] charted-mcp，不要把 pip 路径当成第一次尝试。核心零依赖，不等于 MCP extra 零依赖。本页只点名 create_chart、list_chart_types、list_themes、chart_from_csv。出图有副作用。readOnlyHint 不是零风险。官方还提到 Claude skill，但没有在这些片段里写出 skill 安装步骤。