Quick Chart MCP Server

Quick Chart MCP Server

Um servidor Model Context Protocol (MCP) que fornece ferramentas de gráficos, permitindo interagir com o quick chart por meio de uma interface padronizada. Esta implementação é baseada na definição de gráficos e permite que usuários abram páginas de quick chart de forma integrada.

Visão Geral

Este servidor MCP oferece ferramentas:

• Interagir com o Quick Chart

O servidor implementa a especificação do Model Context Protocol para padronizar interações com gráficos para agentes de IA.

Pré-requisitos

• Node.js (v16 ou superior)
• pnpm (recomendado), npm ou yarn

Instalação

Instalando via Smithery

Para instalar o quick-chart-mcp para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @datafe/quick-chart-mcp --client claude

Opção 1: Instalar via npm (recomendado para clientes como Cursor/Cline)

# Install globally
npm install -g quick-chart-mcp

# Or install locally in your project
npm install quick-chart-mcp

Opção 2: Compilar a partir do código-fonte (para desenvolvedores)

1. Clone este repositório:

git clone https://github.com/datafe/quick-chart-mcp
cd quick-chart-mcp

2. Instale as dependências (pnpm é recomendado, npm é suportado):

pnpm install

3. Compile o projeto:

pnpm run build

4. Desenvolva o projeto (via @modelcontextprotocol/inspector):

pnpm run dev

abra http://localhost:5173

Configuração

Configurações do MCP

{
  "mcpServers": {
    "quick-chart-mcp": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 300,
      "command": "npx",
      "args": [
        "quick-chart-mcp@1.0.13"
      ],
      "transportType": "stdio"
    }
  }
}

Configuração do Ambiente

Crie um arquivo .env com suas credenciais:

# Quick Chart Configuration
NODE_ENV=optional_development_or_product
QUICK_CHART_DRAW_URL=optional_quick_chart_draw_url
NEED_INSTALL_QUICK_CHART=optional_true_or_false

Estrutura do Projeto

quick-chart-mcp/
├── src/
│   ├── index.ts          # Main entry point
├── package.json
└── tsconfig.json

Ferramentas Disponíveis

O servidor MCP fornece as seguintes ferramentas do Quick Chart:

• GetChartImgLink - Recupera o link da imagem do gráfico por parâmetros.
• InstallQuickChart - Instala o serviço quick chart localmente.

Considerações de Segurança

• Use variáveis de ambiente para informações sensíveis
• Monitore e audite regularmente as atividades dos agentes de IA

Solução de Problemas

Se você encontrar problemas:

1. Verifique se a compilação foi bem-sucedida

Dependências

APIs de imagem.

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

1. Faça um fork do repositório
2. Crie sua branch de funcionalidade (git checkout -b feature/amazing-feature)
3. Faça commit das suas alterações (git commit -m 'Add some amazing feature')
4. Envie para a branch (git push origin feature/amazing-feature)
5. Abra um Pull Request

Licença

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