安裝
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 安裝步驟。