ECharts MCP Server

Um servidor para gerar vários tipos de gráficos usando a biblioteca ECharts.

Documentação

Servidor MCP ECharts build npm Version smithery badge npm License

Um servidor Model Context Protocol para gerar gráficos usando ECharts, inspirado em AntV.

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. Você também pode usá-lo no Dify.

✨ Recursos

Quase todos os tipos de gráficos são suportados. Cada ferramenta retornará uma URL de pré-visualização do gráfico, que é a página oficial de pré-visualização de gráficos do ECharts.

Por exemplo, este gráfico de pizza

  • generate_bar_chart - Gera um gráfico de bar.
  • generate_line_chart - Gera um gráfico de line.
  • generate_pie_chart - Gera um gráfico de pie.
  • generate_scatter_chart - Gera um gráfico de scatter.
  • generate_radar_chart - Gera um gráfico de radar.
  • generate_heatmap_chart - Gera um gráfico de heatmap.
  • generate_general_chart - Gera um gráfico de effectScatter, tree, treemap, sunburst, boxplot, candlestick, graph, sankey, funnel, gauge or themeRiver.

🤖 Uso

Para usar com Desktop APP, como Claude, VSCode, Cline, Cherry Studio, Cursor, entre outros, adicione a configuração do servidor MCP abaixo.

{
  "mcpServers": {
    "echarts-server": {
      "command": "node",
      "args": [
        "your-path/echarts-mcp-server/build/index.js"
      ]
    }
  }
}

Ou

{
  "mcpServers": {
    "echarts-server": {
      "command": "npx",
      "args": [
        "-y",
        "echarts-mcp-server"
      ]
    }
  }
}

Além disso, você pode usá-lo no aliyun, modelscope, glama.ai, smithery.ai ou outros com protocolo HTTP ou SSE.

🚰 Executar com transporte SSE ou Streamable

Instale o pacote globalmente.

npm install -g echarts-mcp-server

Execute o servidor com a opção de transporte de sua preferência:

# For SSE transport (default endpoint: /sse)
echarts-mcp-server --transport sse

# For Streamable transport with custom endpoint
echarts-mcp-server --transport streamable

Então você pode acessar o servidor em:

  • Transporte SSE: http://localhost:1122/sse
  • Transporte Streamable: http://localhost:1122/mcp

🎮 Opções de CLI

Você também pode usar as seguintes opções de CLI ao executar o servidor MCP. Opções de comando executando a CLI com -h.

MCP Server Chart CLI

Options:
  --transport, -t  Specify the transport protocol: "stdio", "sse", or "streamable" (default: "stdio")
  --port, -p       Specify the port for SSE or streamable transport (default: 1122)
  --endpoint, -e   Specify the endpoint for the transport:
                   - For SSE: default is "/sse"
                   - For streamable: default is "/mcp"
  --help, -h       Show this help message

🔨 Desenvolvimento

Instale as dependências:

npm install

Compile o servidor:

npm run build

Inicie o servidor MCP:

npm run start