charted MCP : démarrer avec uvx, appeler list_chart_types, puis dessiner

Pour qui

Vous voulez qu'un agent produise des graphiques SVG ou PNG sans ajouter charted aux dépendances du projet. Le chemin MCP officiel utilise uvx pour lever charted avec l'extra MCP dans un environnement à usage unique et sert via stdio. La bibliothèque cœur n'a aucune dépendance d'exécution ; l'export PNG et MCP sont des extras optionnels qui amènent leurs dépendances, la base reste du Python pur.

Cela convient pour demander d'abord quels types et thèmes existent, puis décider de générer. Le texte officiel indique 15 types. Au premier essai, ne suivez pas les notes pip non développées.

Dépôt officiel seul sur une ligne :

https://github.com/marzukia/charted

Ancre de détail d'outils seule sur une ligne :

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

Premier essai en 3 minutes

Uniquement cette commande uvx :

uvx --from charted[mcp] charted-mcp

Enregistrement Claude Code :

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

Cursor, Cline et les autres clients mettent la même commande dans leur configuration MCP. N'installez pas en parallèle un environnement virtuel interne au projet comme voie principale.

Préalable : uvx est présent. uvx tire l'extra MCP de charted dans un environnement à usage unique.

Où configurer : Claude Code utilise la ligne add ; les autres clients mettent la même commande uvx dans la configuration MCP server et démarrent en stdio.

Premier pas à bas risque : appeler list_chart_types pour renvoyer les types. Ou list_themes pour les thèmes. Les deux sont des inventaires et n'écrivent aucun fichier. Le signal de succès est un ensemble de types ou de thèmes. Ne lisez pas cet inventaire comme hors réseau : uvx récupère encore le paquet et démarre un processus local.

Si l'ensemble est normal, envisagez alors de dessiner. create_chart génère un graphique ; chart_from_csv dessine depuis un CSV. Dessiner produit du SVG ou PNG côté agent et n'est pas en lecture seule. Avant l'appel, confirmez que les données peuvent aller dans cet environnement à usage unique ; après, obtenir un graphique est le signal de succès. Le texte officiel n'écrit ni chemin disque ni commande d'annulation.

Cas d'usage

Cas 1 : voir d'abord les types pris en charge. Appelez list_chart_types. Appelez list_themes s'il faut des thèmes. Le texte officiel ne donne que les noms d'outils, sans énumérer les 15 types.

Cas 2 : dessiner depuis des données structurées ou un CSV. Appelez create_chart, ou chart_from_csv depuis un CSV. La sortie peut être SVG ou PNG. PNG, comme MCP, est un extra opt-in. Le texte officiel ne donne ni noms de champs, ni noms de thèmes, ni convention de colonnes CSV.

Limites d'usage

La voie principale est uvx --from charted[mcp] charted-mcp ; ne prenez pas un chemin pip pour le premier essai. Cœur sans dépendance ne veut pas dire extra MCP sans dépendance. Cette page ne nomme que create_chart, list_chart_types, list_themes, chart_from_csv. Dessiner a des effets de bord. readOnlyHint n'est pas un risque nul. Le texte officiel mentionne aussi un Claude skill, mais ces extraits n'écrivent pas les étapes d'installation du skill.