MCP

charted MCP: comece com uvx, chame list_chart_types e só então desenhe

Para um agente emitir SVG/PNG sem colocar a biblioteca no projeto. Comece com uvx, confirme tipos com list_chart_types e depois create_chart.

Official source · charted

Install

uvx --from charted[mcp] charted-mcp

Para quem

Você quer que um agente emita gráficos SVG ou PNG e não quer colocar charted nas dependências do projeto. O caminho MCP oficial usa uvx para subir charted com o extra MCP num ambiente de uso único e servir via stdio. A biblioteca núcleo não tem dependências de execução; exportação PNG e MCP são extras opcionais que trazem dependências, e a base continua Python puro.

Combina perguntar primeiro quais tipos e temas existem e só então decidir gerar. O texto oficial indica 15 tipos. Na primeira tentativa não siga as notas pip não expandidas.

Repositório oficial sozinho numa linha:

https://github.com/marzukia/charted

Âncora de detalhe das ferramentas sozinha numa linha:

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

Primeira tentativa em 3 minutos

Só este comando uvx:

uvx --from charted[mcp] charted-mcp

O registro no Claude Code é:

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

Cursor, Cline e outros clientes colocam o mesmo comando na configuração MCP. Não instale em paralelo um ambiente virtual interno ao projeto como caminho principal.

Pré-requisito: há uvx nesta máquina. O uvx puxa o extra MCP do charted para um ambiente de uso único.

Onde configurar: o Claude Code usa a linha add; os outros colocam o mesmo comando uvx na configuração MCP server e sobem em stdio.

Primeiro passo de baixo risco: chame list_chart_types para devolver tipos. Ou list_themes para temas. Ambos são inventários e não criam arquivos. O sinal de sucesso é um conjunto de tipos ou temas. Não leia esse inventário como sem rede: o uvx ainda busca o pacote e sobe um processo local.

Se o conjunto estiver normal, então pense em desenhar. create_chart gera um gráfico; chart_from_csv desenha a partir de CSV. Desenhar produz SVG ou PNG do lado do agente e não é somente leitura. Antes de chamar, confirme que os dados podem ir a este ambiente de uso único; depois, obter um gráfico é o sinal de sucesso. O texto oficial não escreve caminho em disco nem comando de desfazer.

Casos de uso

Caso 1: ver primeiro quais tipos existem. Chame list_chart_types. Chame list_themes se precisar de temas. O texto oficial só dá os nomes das ferramentas; não enumera os 15 tipos.

Caso 2: desenhar a partir de dados estruturados ou CSV. Chame create_chart, ou chart_from_csv a partir de CSV. A saída pode ser SVG ou PNG. PNG, como MCP, é um extra opt-in. O texto oficial não dá nomes de campo, nomes de tema nem convenção de colunas CSV.

Limites de uso

O caminho principal é uvx --from charted[mcp] charted-mcp; não trate um caminho pip como primeira tentativa. Núcleo sem dependência não é extra MCP sem dependência. Esta página só nomeia create_chart, list_chart_types, list_themes, chart_from_csv. Desenhar tem efeitos colaterais. readOnlyHint não é risco zero. O texto oficial também menciona um Claude skill, mas estes trechos não escrevem os passos de instalação do skill.