MCP

charted MCP: arranca con uvx, llama a list_chart_types y luego dibuja

Para que un agente emita SVG/PNG sin meter la biblioteca en el proyecto. Empieza con uvx, confirma tipos con list_chart_types y luego create_chart.

Official source · charted

Install

uvx --from charted[mcp] charted-mcp

Para quién

Quieres que un agente emita gráficos SVG o PNG y no quieres añadir charted a las dependencias del proyecto. La ruta MCP oficial usa uvx para levantar charted con el extra MCP en un entorno de un solo uso y servir por stdio. La biblioteca núcleo no tiene dependencias de ejecución; la exportación PNG y MCP son extras opcionales que traen dependencias, y la base sigue siendo Python puro.

Encaja preguntar primero qué tipos y temas hay y luego decidir si generar. El texto oficial indica 15 tipos. En el primer intento no sigas las notas pip sin expandir.

Repositorio oficial en su propia línea:

https://github.com/marzukia/charted

Ancla de detalle de herramientas en su propia línea:

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

Primer intento en 3 minutos

Solo este comando uvx:

uvx --from charted[mcp] charted-mcp

El registro en Claude Code es:

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

Cursor, Cline y otros clientes ponen el mismo comando en su configuración MCP. No instales en paralelo un entorno virtual interno al proyecto como vía principal.

Requisito: hay uvx en esta máquina. uvx trae el extra MCP de charted a un entorno de un solo uso.

Dónde configurar: Claude Code usa la línea add; los demás ponen el mismo comando uvx en la configuración MCP server y arrancan por stdio.

Primer paso de bajo riesgo: llama a list_chart_types para devolver tipos. O a list_themes para temas. Ambos son inventarios y no crean archivos. La señal de éxito es un conjunto de tipos o temas. No leas ese inventario como sin red: uvx sigue trayendo el paquete y arranca un proceso local.

Si el conjunto se ve normal, entonces plantea dibujar. create_chart genera un gráfico; chart_from_csv dibuja desde CSV. Dibujar produce SVG o PNG en el lado del agente y no es solo lectura. Antes de llamar, confirma que los datos pueden ir a este entorno de un solo uso; después, obtener un gráfico es la señal de éxito. El texto oficial no escribe ruta en disco ni comando de deshacer.

Casos de uso

Caso 1: ver primero qué tipos hay. Llama a list_chart_types. Llama a list_themes si necesitas temas. El texto oficial solo da los nombres de herramienta; no enumera los 15 tipos.

Caso 2: dibujar desde datos estructurados o CSV. Llama a create_chart, o a chart_from_csv desde CSV. La salida puede ser SVG o PNG. PNG, como MCP, es un extra opt-in. El texto oficial no da nombres de campo, nombres de tema ni convención de columnas CSV.

Límites de uso

La vía principal es uvx --from charted[mcp] charted-mcp; no trates una vía pip como primer intento. Núcleo sin dependencias no es extra MCP sin dependencias. Esta página solo nombra create_chart, list_chart_types, list_themes, chart_from_csv. Dibujar tiene efectos secundarios. readOnlyHint no es riesgo cero. El texto oficial también menciona un Claude skill, pero estos extractos no escriben los pasos de instalación del skill.