MCP

charted MCP: mit uvx starten, list_chart_types prüfen, dann zeichnen

Wenn ein Agent SVG/PNG erzeugen soll, ohne die Bibliothek ins Projekt zu schreiben. Zuerst uvx starten, Typen mit list_chart_types prüfen, dann create_chart.

Official source · charted

Install

uvx --from charted[mcp] charted-mcp

Für wen

Ihr wollt, dass ein Agent direkt SVG- oder PNG-Diagramme ausgibt, ohne charted zuerst in die Projektabhängigkeiten zu schreiben. Der offizielle MCP-Weg startet charted mit dem MCP extra per uvx in einer Einmalumgebung und dient über stdio. Die Kernbibliothek hat keine Laufzeitabhängigkeiten; PNG-Export und MCP sind optionale extras mit eigenen Abhängigkeiten, die Basis bleibt reines Python.

Es passt, zuerst nach Diagrammtypen und Themen zu fragen und erst dann zu erzeugen. Offiziell stehen 15 Diagrammtypen. Beim ersten Versuch nicht die unausgeklappten pip-Hinweise nutzen.

Offizielles Repo in einer eigenen Zeile:

https://github.com/marzukia/charted

Tool-Detailanker in einer eigenen Zeile:

https://github.com/marzukia/charted#mcp-server-ai-agent-integration

Erster Versuch in 3 Minuten

Nur diesen uvx-Befehl:

uvx --from charted[mcp] charted-mcp

Registrierung in Claude Code:

claude mcp add charted -- uvx --from charted[mcp] charted-mcp

Cursor, Cline und andere Clients schreiben denselben Befehl in ihre MCP-Konfiguration. Nicht parallel eine projektinterne virtuelle Umgebung als Hauptweg installieren.

Voraussetzung: uvx ist vorhanden. uvx holt das MCP extra von charted in eine Einmalumgebung.

Konfiguration: Claude Code nutzt die add-Zeile; andere Clients tragen denselben uvx-Befehl in die MCP-server-Konfiguration ein und starten über stdio.

Risikoarmer erster Schritt: list_chart_types aufrufen und Diagrammtypen zurückgeben. Oder list_themes für Themen. Beides sind Inventare und erzeugen keine Dateien. Erfolgssignal ist eine zurückgegebene Typ- oder Themenmenge. Dieses Inventar nicht als offline lesen: uvx holt trotzdem das Paket und startet einen lokalen Prozess.

Sieht die Menge normal aus, dann Zeichnen erwägen. create_chart erzeugt ein Diagramm; chart_from_csv zeichnet aus CSV. Zeichnen erzeugt SVG oder PNG auf der Agentseite und ist nicht nur lesend. Vor dem Aufruf klären, dass die Daten in diese Einmalumgebung dürfen; danach ist ein erhaltenes Diagramm das Erfolgssignal. Offizieller Text nennt keinen Speicherpfad und keinen Rücknahmebefehl.

Anwendungsfälle

Fall 1: Zuerst sehen, welche Typen unterstützt sind. list_chart_types aufrufen. Bei Bedarf list_themes. Offizieller Text nennt nur die Toolnamen, keine Aufzählung der 15 Typen.

Fall 2: Aus strukturierten Daten oder CSV zeichnen. create_chart zum Erzeugen oder chart_from_csv aus CSV. Ausgabe kann SVG oder PNG sein. PNG ist wie MCP ein opt-in extra. Offizieller Text nennt keine Feldnamen, Themennamen oder CSV-Spaltenregeln.

Grenzen

Hauptweg ist uvx --from charted[mcp] charted-mcp; einen pip-Weg nicht als ersten Versuch nehmen. Abhängigkeitsfreier Kern heißt nicht abhängigkeitsfreies MCP extra. Diese Seite nennt nur create_chart, list_chart_types, list_themes, chart_from_csv. Zeichnen hat Nebenwirkungen. readOnlyHint ist kein Nullrisiko. Offizieller Text erwähnt auch ein Claude skill, schreibt in diesen Auszügen aber keine skill-Installationsschritte.