amCharts 5 MCP Server

Servidor MCP de amCharts 5

Un servidor MCP (Model Context Protocol) que da a los asistentes de IA acceso bajo demanda a la base de conocimiento completa de amCharts 5: más de 160 páginas de documentación, más de 290 ejemplos de código y más de 1.300 páginas de referencia de la API.

Funciona con Claude Code, Claude Desktop, Cursor, Windsurf, VS Code + GitHub Copilot y cualquier otra herramienta de IA compatible con MCP.

¿Por qué?

En lugar de cargar toda la referencia de amCharts en la ventana de contexto de la IA, el servidor MCP permite que la IA consulte exactamente lo que necesita: la referencia de un tipo de gráfico específico, un ejemplo de código o una consulta a la API. Esto se traduce en mejores respuestas con menos desperdicio de contexto.

Inicio rápido

La forma más sencilla es el servidor alojado: sin instalación, solo añade una URL. ¿Prefieres ejecutarlo tú mismo? Consulta Instalación local más abajo.

Alojado (sin instalación) — recomendado

Apunta tu cliente de IA a:

https://mcp.amcharts.com/mcp

Claude Code

claude mcp add --transport http amcharts5 https://mcp.amcharts.com/mcp

Claude Desktop / claude.ai — Ajustes → Conectores → Añadir conector personalizado, y luego pega https://mcp.amcharts.com/mcp.

Cursor — .cursor/mcp.json:

{
  "mcpServers": {
    "amcharts5": {
      "url": "https://mcp.amcharts.com/mcp"
    }
  }
}

VS Code + GitHub Copilot — .vscode/mcp.json:

{
  "servers": {
    "amcharts5": {
      "type": "http",
      "url": "https://mcp.amcharts.com/mcp"
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "amcharts5": {
      "serverUrl": "https://mcp.amcharts.com/mcp"
    }
  }
}

ChatGPT (Plus/Pro/Enterprise con conectores/modo desarrollador habilitado) — Ajustes → Conectores → Añadir conector personalizado, y luego pega https://mcp.amcharts.com/mcp.

Cline (extensión de VS Code) — abre el panel MCP Servers → Remote Servers, pega https://mcp.amcharts.com/mcp, o añádelo al JSON de ajustes de MCP:

{
  "mcpServers": {
    "amcharts5": {
      "type": "streamableHttp",
      "url": "https://mcp.amcharts.com/mcp"
    }
  }
}

Clientes que solo admiten servidores locales (stdio) (p. ej. Zed, Continue, Amazon Q Developer) — conecta con la URL alojada mediante mcp-remote. Usa esto como comando de ejecución del servidor en la configuración del cliente:

npx mcp-remote https://mcp.amcharts.com/mcp

Por ejemplo, en una configuración estilo command/args:

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.amcharts.com/mcp"]
    }
  }
}

También funciona cualquier otro cliente MCP que acepte una URL de servidor remoto: usa el endpoint /mcp (Streamable HTTP) o /sse (SSE heredado). Para los clientes que solo aceptan URL y aún esperan un comando, usa el puente mcp-remote mostrado arriba.

Instalación local (npx)

¿Prefieres ejecutarlo tú mismo? El servidor también está publicado en npm y se ejecuta sobre stdio.

Claude Code

Para todos los proyectos (global, recomendado):

claude mcp add -s user amcharts5 -- npx -y @amcharts/amcharts5-mcp

Solo para el proyecto actual:

claude mcp add amcharts5 -- npx -y @amcharts/amcharts5-mcp

Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

Cursor

Crea o edita .cursor/mcp.json en la raíz de tu proyecto (o ~/.cursor/mcp.json para global):

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

Windsurf

Edita ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

VS Code + GitHub Copilot

Crea o edita .vscode/mcp.json en tu espacio de trabajo:

{
  "servers": {
    "amcharts5": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

Otras herramientas compatibles con MCP

Para cualquier otra herramienta que admita MCP (Cline, Continue, Amazon Q, Zed, etc.), configúrala para ejecutar:

npx -y @amcharts/amcharts5-mcp

Ejecutar localmente (para desarrollo)

git clone https://github.com/amcharts/amcharts5-mcp.git
cd amcharts5-mcp
npm install
npm start

Herramientas disponibles

Herramienta	Descripción
get_core_reference	Obtiene la documentación básica de amCharts 5: configuración, temas, colores, eventos, errores comunes
get_chart_reference	Obtiene la referencia completa de un tipo de gráfico (p. ej. "pie", "sankey", "xy")
list_chart_types	Enumera todos los tipos de gráfico disponibles y sus palabras clave
search_docs	Busca en los documentos de referencia de la skill por palabra clave (scope: "all" añade la documentación completa, la referencia de la API y los ejemplos)
search_all	Busca en todo: documentos de la skill, documentación completa y ejemplos de código
get_doc	Obtiene una página de documentación completa (p. ej. "charts/xy-chart/axes", "concepts/events")
get_section	Obtiene una sección específica de un archivo de referencia por su encabezado
get_quick_start	Obtiene una plantilla mínima funcional para cualquier tipo de gráfico
list_examples	Explora los más de 290 ejemplos, opcionalmente filtrados por categoría
get_example	Obtiene el código completo de un ejemplo específico
get_api_reference	Obtiene la referencia de la API de una clase, interfaz o función: ajustes con sus valores predeterminados, eventos, herencia y la línea de importación
list_geodata	Encuentra archivos de mapas (geodatos): mundo, continentes, países, paquetes regionales y los paquetes de distritos congresionales de EE. UU. por Congreso, con la ruta CDN, el global de script y la importación ES de cada archivo

Ejemplo de uso

Una vez conectado, tu asistente de IA puede:

• "Créame un gráfico circular" → la IA llama a get_quick_start("pie") y adapta la plantilla
• "¿Cómo formateo las etiquetas del eje de fechas?" → la IA llama a search_all("date axis label format")
• "Muéstrame el ejemplo del diagrama de Sankey" → la IA llama a get_example("examples/flow/sankey-diagram")
• "¿Qué ajustes admite XYChart?" → la IA llama a get_doc("reference/xychart")
• "¿Cómo integro con React?" → la IA llama a get_doc("getting-started/integrations/react"), que cubre el paquete @amcharts/amcharts5-react
• "¿Qué tipos de gráfico hay disponibles?" → la IA llama a list_chart_types()
• "Mapea los distritos congresionales actuales de EE. UU." → la IA llama a list_geodata("congressional whole country")

Contenido

El servidor incluye más de 1.800 documentos:

• Más de 160 páginas de documentación: primeros pasos, guías de gráficos, conceptos (temas, eventos, adaptadores, enlace de datos, animaciones, accesibilidad, etc.) y guías de integración de frameworks para los paquetes de amCharts para React, Vue, Angular, Svelte y React Native (con Next.js, Nuxt, SvelteKit, React Router y Remix 3)
• Más de 290 ejemplos de código: demos funcionales en 16 categorías, incluidas columnas/barras, líneas/áreas, circular/dona, mapas, jerarquía, flujo, radar/polar, bolsa, indicadores, Gantt, línea de tiempo y más
• Más de 1.300 páginas de referencia de la API: cada clase, interfaz y función de la biblioteca amCharts 5, generadas a partir de las definiciones de tipos de la versión: ajustes con sus valores predeterminados reales (incluidas las reglas de temas), eventos, propiedades, campos de elementos de datos, la cadena de herencia y la línea de importación
• Más de 670 entradas de geodatos: todos los mapas de @amcharts/amcharts5-geodata, para list_geodata
• Referencia de skill curada: plantillas de inicio rápido y guías específicas por gráfico de la amCharts 5 AI Skill

Seguridad

• Herramientas de solo lectura. Todas las herramientas leen la documentación de amCharts incluida y devuelven texto. Ninguna herramienta escribe archivos, ejecuta comandos ni obtiene URLs.
• El endpoint alojado no tiene autenticación, por diseño. https://mcp.amcharts.com/mcp sirve la misma documentación pública que amcharts.com. No hay cuentas, claves de API, datos de usuario ni operaciones de escritura detrás de él.
  • Se ejecuta en Cloudflare Workers.
  • El estado de la sesión MCP se guarda en un Durable Object, como exige el framework de agentes MCP. Se elimina cuando termina la sesión, o 24 horas después de su última solicitud.
  • Los registros por solicitud (registros de invocación de Workers) están desactivados. Solo se registran los mensajes de error, y no contienen argumentos de herramientas. Consulta "Privacidad" más abajo.
• Instalación local. El paquete npm se ejecuta sobre stdio en tu máquina y solo lee el contenido incluido en él; no realiza solicitudes de red. Sus únicas dependencias en tiempo de ejecución son @modelcontextprotocol/sdk y zod.
• Scripts del mantenedor. Los scripts de scripts/ (los scrapers de la demo y la documentación, el generador de la referencia de la API) no forman parte del paquete npm y nunca se ejecutan en el servidor.
• Informar de una vulnerabilidad: https://www.amcharts.com/report-vulnerability/

Privacidad

Ni el servidor alojado ni el paquete npm necesitan una cuenta ni solicitan datos personales.

• Servidor alojado (https://mcp.amcharts.com/mcp):
  • Qué envía tu aplicación de IA: una frase de búsqueda, un tipo de gráfico, una ruta de documentación. Se usan solo para construir la respuesta y no se registran ni se almacenan. Una respuesta se conserva en el almacenamiento de la sesión solo hasta que se ha entregado (para que un flujo interrumpido pueda reanudarse) y luego se elimina.
  • Registro de sesión: cuando una aplicación de IA se conecta, el servidor guarda su mensaje de inicialización MCP en el almacenamiento de la sesión. Ese mensaje contiene lo que la aplicación dice sobre sí misma (su nombre y versión, y cualquier otra cosa que incluya), la versión del protocolo y las capacidades MCP de la aplicación. Todo el almacenamiento de la sesión se elimina cuando la aplicación finaliza la sesión, o 24 horas después de su última solicitud.
  • Registros: el servidor no guarda registros de solicitudes (los registros de invocación de Workers están desactivados). Se ejecuta en Cloudflare Workers, y Cloudflare procesa cada solicitud, incluida su dirección IP, para entregarla. Los mensajes de error y advertencia se registran y se conservan hasta 7 días; no contienen el contenido de las solicitudes ni argumentos de herramientas.
• Paquete npm: se ejecuta en tu ordenador sobre stdio y no envía nada a amCharts ni a nadie más.
• Política y preguntas: consulta la política de privacidad de amCharts, o escribe a contact@amcharts.com.

Licencia

MIT