QuickChart Server

Gere imagens e URLs de gráficos usando a API QuickChart.io com configurações Chart.js.

Documentação

quickchart-server MCP Server

Um servidor Model Context Protocol para gerar gráficos usando QuickChart.io

Este é um servidor MCP baseado em TypeScript que fornece capacidades de geração de gráficos. Ele permite criar vários tipos de gráficos por meio de ferramentas MCP.

Visão Geral

Este servidor integra-se ao serviço de geração de gráficos baseado em URL do QuickChart.io para criar imagens de gráficos usando configurações Chart.js. Os usuários podem gerar vários tipos de gráficos fornecendo dados e parâmetros de estilo, que o servidor converte em URLs de gráficos ou imagens para download.

Recursos

Ferramentas

generate_chart - Gera uma URL de gráfico usando QuickChart.io
- Suporta vários tipos de gráficos: bar, line, pie, doughnut, radar, polarArea, scatter, bubble, radialGauge, speedometer
- Personalizável com rótulos, conjuntos de dados, cores e opções adicionais
- Retorna uma URL para o gráfico gerado
download_chart - Baixa uma imagem de gráfico para um arquivo local
- Recebe a configuração do gráfico e o caminho de saída como parâmetros
- Salva a imagem do gráfico no local especificado

Tipos de Gráficos Suportados

Gráficos de barra: Para comparar valores entre categorias
Gráficos de linha: Para mostrar tendências ao longo do tempo
Gráficos de pizza: Para exibir dados proporcionais
Gráficos de rosca: Semelhantes aos gráficos de pizza com centro vazado
Gráficos de radar: Para mostrar dados multivariados
Gráficos de área polar: Para exibir dados proporcionais com segmentos de ângulo fixo
Gráficos de dispersão: Para mostrar distribuições de pontos de dados
Gráficos de bolha: Para visualização de dados tridimensionais
Medidor radial: Para exibir valores únicos dentro de um intervalo
Velocímetro: Para exibição de valores no estilo velocímetro

Uso

Configuração do Gráfico

O servidor usa o formato de configuração Chart.js. Aqui está um exemplo básico:

{
  "type": "bar",
  "data": {
    "labels": ["January", "February", "March"],
    "datasets": [{
      "label": "Sales",
      "data": [65, 59, 80],
      "backgroundColor": "rgb(75, 192, 192)"
    }]
  },
  "options": {
    "title": {
      "display": true,
      "text": "Monthly Sales"
    }
  }
}

Geração de URL

O servidor converte sua configuração em uma URL do QuickChart:

https://quickchart.io/chart?c={...encoded configuration...}

Desenvolvimento

Instale as dependências:

npm install

Compile o servidor:

npm run build

Instalação

npm install @gongrzhe/quickchart-mcp-server

Instalação via Smithery

Para instalar o QuickChart Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @gongrzhe/quickchart-mcp-server --client claude

Para usar com o Claude Desktop, adicione a configuração do servidor:

No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "quickchart-server": {
      "command": "node",
      "args": ["/path/to/quickchart-server/build/index.js"]
    }
  }
}

{
  "mcpServers": {
    "quickchart-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gongrzhe/quickchart-mcp-server"
      ]
    }
  }
}

Referências de Documentação

📜 Licença

Este projeto está licenciado sob a Licença MIT.