Quick Chart MCP Server

Un servidor para crear gráficos y visualizaciones usando la API de Quick Chart.

Documentación

Servidor MCP Quick Chart

Un servidor del Protocolo de Contexto de Modelos (MCP) que proporciona herramientas de gráficos, permitiendo interactuar con el quick chart a través de una interfaz estandarizada. Esta implementación se basa en la definición de gráficos y permite a los usuarios abrir páginas de quick chart sin problemas.

Resumen

Este servidor MCP incluye herramientas para:

Interactuar con Quick Chart

El servidor implementa la especificación del Protocolo de Contexto de Modelos para estandarizar las interacciones de gráficos para agentes de IA.

Requisitos previos

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

Instalación

Instalación mediante Smithery

Para instalar quick-chart-mcp para Claude Desktop automáticamente a través de Smithery:

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

Opción 1: Instalar desde 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

Opción 2: Compilar desde el código fuente (para desarrolladores)

Clona este repositorio:

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

Instala las dependencias (se recomienda pnpm, npm también es compatible):

pnpm install

Compila el proyecto:

pnpm run build

Desarrolla el proyecto (mediante @modelcontextprotocol/inspector):

pnpm run dev

abre http://localhost:5173

Configuración

Configuraciones de MCP

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

Configuración del entorno

Crea un archivo .env con tus credenciales:

# 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

Estructura del proyecto

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

Herramientas disponibles

El servidor MCP proporciona las siguientes herramientas de Quick Chart:

GetChartImgLink - Obtiene el enlace de la imagen del gráfico según los parámetros.
InstallQuickChart - Instala el servicio de quick chart localmente.

Consideraciones de seguridad

Usa variables de entorno para información sensible
Supervisa y audita regularmente las actividades de los agentes de IA

Solución de problemas

Si encuentras problemas:

Verifica que la compilación se haya realizado correctamente

Dependencias

APIs de imágenes.

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).

Haz un fork del repositorio
Crea tu rama de funcionalidad (git checkout -b feature/amazing-feature)
Realiza tus cambios (git commit -m 'Add some amazing feature')
Envía los cambios a la rama (git push origin feature/amazing-feature)
Abre una Solicitud de Extracción

Licencia

Este proyecto está licenciado bajo la Licencia MIT.