MCP ECharts: ferramenta MCP para gerar gráficos de visualização ECharts

O mcp-echarts é uma ferramenta que permite que os modelos de linguagem grande (LLMs) de IA gerem dinamicamente gráficos visuais do Apache ECharts. Ela atua como um servidor de protocolo de contexto de modelo (MCP) que os assistentes de IA podem chamar para criar gráficos avançados com base em comandos e dados inseridos pelo usuário. Por exemplo, o usuário pode dizer à IA "faça um gráfico de barras com esses dados de vendas" e a IA usará o mcp-echarts para criar o gráfico. Essa ferramenta é caracterizada por ser executada totalmente localmente, sem depender de nenhum serviço remoto, garantindo a segurança dos dados. Ao mesmo tempo, ela é fácil de instalar e pode ser integrada ao armazenamento de objetos MinIO para compartilhar os gráficos gerados na forma de links, o que aumenta a eficiência da transmissão e do compartilhamento. Dessa forma, o mcp-echarts capacita os aplicativos de IA com a capacidade de visualizar dados dinâmicos, permitindo uma análise de dados e uma apresentação de resultados mais intuitivas.

Lista de funções

• Suporte completo a EChartsSuporte total a todos os recursos e à sintaxe do Apache ECharts, incluindo dados, estilos, temas e muito mais.
• Vários formatos de exportaçãoSuporte à exportação de gráficos gerados como pngesvg formato de imagem ou saída do ECharts' option Arquivo de configuração.
• verificação gramaticalCalibração: um recurso de calibração integrado que ajuda os modelos de IA a passar por várias rodadas de diálogo e, por fim, gerar configurações de gráficos sintaticamente corretas.
• Integração do MinIOSuporte à integração com o serviço de armazenamento de objetos MinIO. Quando ativado, os gráficos gerados serão carregados no MinIO e retornarão um link de URL em vez de um fluxo de dados Base64, que é mais adequado para transmissão e compartilhamento em rede. Se o MinIO não estiver configurado, a ferramenta voltará automaticamente para a saída no formato Base64.
• Instalação leveIsso pode ser feito por npx Os comandos são executados diretamente, sem processos de instalação complicados e dependências externas.
• Operação localizadaO processo de geração de gráficos é feito inteiramente no computador local e não se comunica com nenhum servidor remoto, o que garante a segurança dos dados e da privacidade.
• Vários protocolos de comunicaçãoSuporte ao uso de entradas e saídas padrão (stdio), o servidor envia um evento (sse) e streaming (streamable) e muitos outros protocolos para integração com aplicativos de IA.

Usando a Ajuda

Em sua essência, o mcp-echarts atua como um serviço em segundo plano que os aplicativos de IA (por exemplo, Claude no desktop, plug-ins de VSCode etc.) podem chamar para gerar gráficos. Normalmente, os usuários não operam o mcp-echarts diretamente, mas configuram os aplicativos de IA para usá-lo.

1. início rápido (integração de aplicativos de desktop)

Esse é o uso mais comum, com o mcp-echarts especificado como uma ferramenta disponível nas configurações do aplicativo de IA.

Método de configuração::
No arquivo de configuração dos aplicativos de IA que suportam o protocolo MCP (por exemplo, Claude Desktop Edition, VSCode etc.), adicione o parâmetro mcpServers Parte.

• No macOS::

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

• Em sistemas Windows::

{
"mcpServers": {
"mcp-echarts": {
"command": "cmd",
"args": [ "/c", "npx", "-y", "mcp-echarts" ]
}
}
}
```配置完成后，当你在这些应用中向AI发出绘图指令时，AI就会自动调用 `npx -y mcp-echarts` 命令来执行图表生成任务。 `npx -y` 会自动下载并运行最新版本的 mcp-echarts，无需用户手动安装。
### **2. 作为独立服务器运行**
如果你需要将 mcp-echarts 作为一个独立的HTTP服务部署，供其他网络应用（如 glama.ai, smithery.ai 等）调用，可以采用SSE或Streamable模式运行。
**安装**：
首先，需要通过 npm 将其全局安装到你的系统中。
```bash
npm install -g mcp-echarts

Início dos serviços::
Selecione um protocolo de transporte para iniciar o serviço conforme necessário.

• Executando o protocolo SSE (Server-Sent Events)::

  mcp-echarts -t sse
  

  Quando o serviço é iniciado, ele escuta, por padrão, no endereço http://localhost:3033/sse.

• É executado no protocolo Streamable::

  mcp-echarts -t streamable
  

  Quando o serviço é iniciado, ele escuta, por padrão, no endereço http://localhost:3033/mcp.

Opções de linha de comando::
Você pode personalizar a configuração do serviço com parâmetros de linha de comando. Executar mcp-echarts -h Veja todas as opções disponíveis.

• --transport, -tProtocolo de transporte: Especifica o protocolo de transporte, com um valor opcional de stdio (padrão),sse talvez streamable.
• --port, -p: para sse talvez streamable O protocolo especifica a porta de escuta (o padrão é 3033).
• --endpoint, -eEspecifique o caminho de acesso para o protocolo de transporte (por exemplo, o padrão do SSE é /sse).

3. (Opcional) Configuração do armazenamento de objetos MinIO

Para melhorar o desempenho e os recursos de compartilhamento, você pode configurar o mcp-echarts para carregar as imagens de gráfico geradas no MinIO ou em outros serviços de armazenamento de objetos compatíveis com o S3.

Etapa 1: iniciar o serviço MinIO
Em primeiro lugar, você precisa ter um serviço MinIO em execução, localmente ou em um servidor. Usando o macOS como exemplo, você pode usar o comando brew Instalação e inicialização rápidas.

# 安装 MinIO
brew install minio/stable/minio
# 启动 MinIO 服务，数据将存储在 ~/minio-data 目录
minio server ~/minio-data --console-address :9001

Etapa 2: Configurar variáveis de ambiente
No diretório raiz do projeto mcp-echarts, crie um arquivo .env Arquivo. Você pode obter o arquivo na seção .env.example Faça uma cópia para começar.

cp .env.example .env```
然后，编辑 `.env` 文件，填入你的MinIO服务器信息：
```env
MINIO_ENDPOINT=localhost
MINIO_PORT=9000
MINIO_USE_SSL=false
MINIO_ACCESS_KEY=minioadmin
MINIO_SECRET_KEY=minioadmin
MINIO_BUCKET_NAME=mcp-echarts

Certifique-se de que MINIO_BUCKET_NAME O bucket de armazenamento especificado (Bucket) foi criado no MinIO. Uma vez configurado, o mcp-echarts carrega os gráficos depois que eles são gerados e retorna um URL. Se a conexão com o MinIO falhar, ele fará o downgrade automaticamente e retornará a codificação Base64 da imagem.

cenário do aplicativo

1. Visualização de dados do assistente de IA
   Quando os usuários estão analisando dados com um assistente de IA, como os integrados ao VSCode ou ao Claude, eles podem comandar a IA para gerar gráficos diretamente em linguagem natural. Por exemplo, um usuário pode carregar um arquivo CSV e dizer: "Por favor, gere um gráfico de linhas mostrando as vendas mensais com base nos dados desse arquivo." O assistente de IA chamará o mcp-echarts para concluir a criação do gráfico.
2. Geração automatizada de relatórios
   Em sistemas que geram automaticamente relatórios de análise de dados, o mcp-echarts pode ser usado como um componente central. Depois de analisar os dados, o programa pode chamar o serviço mcp-echarts para converter os principais dados e conclusões em tabelas e gráficos e incorporá-los ao documento final do relatório, tornando o conteúdo do relatório mais legível.
3. Plataforma de análise de dados on-line
   Aplicativos da Web ou plataformas de análise de dados on-line podem integrar o mcp-echarts como o mecanismo de geração de gráficos de back-end. Os usuários manipulam os dados na interface front-end e o back-end da plataforma envia os dados e as configurações de gráficos para o serviço mcp-echarts, que gera dinamicamente resultados de visualização e os exibe aos usuários.

QA

1. O que é MCP?
   O MCP (Model Context Protocol) é um protocolo projetado para permitir que os LLMs (Large Language Models) interajam com ferramentas ou serviços externos. mcp-echarts é uma ferramenta do lado do servidor que implementa o protocolo, o que permite que os modelos de IA tenham a capacidade de gerar gráficos ECharts chamando esse serviço.
2. Quais tipos de gráficos são compatíveis com o mcp-echarts?
   Teoricamente, ele suporta todos os tipos e recursos de gráficos suportados pelo Apache ECharts. Como seu princípio básico é receber e renderizar os gráficos do ECharts option configurações, portanto, desde que o modelo de IA gere as configurações corretas, omcp-echarts Ele será capaz de renderizá-los, incluindo gráficos de barras comuns, gráficos de linhas, gráficos de pizza, gráficos de dispersão e gráficos de árvore mais complexos, gráficos de sol nascente e assim por diante.
3. Preciso de uma conexão com a Internet para usar o mcp-echarts?
   Não há necessidade.mcp-echarts Todo o trabalho de geração de gráficos é feito localmente, sem depender de nenhum serviço de nuvem externo, o que garante a privacidade e a segurança do processamento de dados. Ele só se conectará ao servidor MinIO que você especificar para carregar imagens se você tiver configurado o armazenamento de objetos MinIO.
4. Por que você recomenda o MinIO?
   Quando a IA gera um gráfico, geralmente é necessário retornar o gráfico (uma imagem) ao front-end para exibição. Se a codificação Base64 da imagem for retornada diretamente, a quantidade de dados será grande e a eficiência da transmissão será baixa. Com o MinIO, você pode armazenar a imagem em um armazenamento de objetos e retornar um URL curto, e o front-end pode simplesmente carregar o URL, o que é mais eficiente e fácil de compartilhar e gerenciar o gráfico gerado.