amCharts 5 MCP Server

Servidor MCP do amCharts 5

Um servidor MCP (Model Context Protocol) que dá aos assistentes de IA acesso sob demanda à base de conhecimento completa do amCharts 5: mais de 160 páginas de documentação, mais de 290 exemplos de código e mais de 1.300 páginas de referência da API.

Funciona com Claude Code, Claude Desktop, Cursor, Windsurf, VS Code + GitHub Copilot e qualquer outra ferramenta de IA compatível com MCP.

Por quê?

Em vez de carregar toda a referência do amCharts na janela de contexto da IA, o servidor MCP permite que a IA consulte exatamente o que precisa — a referência de um tipo específico de gráfico, um exemplo de código ou uma consulta à API. Isso significa respostas melhores com menos desperdício de contexto.

Início Rápido

A maneira mais fácil é o servidor hospedado — sem instalação, basta adicionar uma URL. Prefere executá-lo você mesmo? Veja Instalação local abaixo.

Hospedado (sem instalação) — recomendado

Aponte seu cliente de IA para:

https://mcp.amcharts.com/mcp

Claude Code

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

Claude Desktop / claude.ai — Configurações → Conectores → Adicionar conector personalizado, depois cole 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 com conectores/modo desenvolvedor habilitado) — Configurações → Conectores → Adicionar conector personalizado, depois cole https://mcp.amcharts.com/mcp.

Cline (extensão do VS Code) — abra o painel MCP Servers → Remote Servers, cole https://mcp.amcharts.com/mcp, ou adicione ao JSON de configurações MCP dele:

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

Clientes que só suportam servidores locais (stdio) (por exemplo, Zed, Continue, Amazon Q Developer) — faça a ponte para a URL hospedada com mcp-remote. Use isto como comando de execução do servidor na configuração do cliente:

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

Por exemplo, em uma configuração no estilo command/args:

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

Qualquer outro cliente MCP que aceite uma URL de servidor remoto também funciona — use o endpoint /mcp (Streamable HTTP) ou /sse (SSE legado). Para clientes que só aceitam URL mas ainda esperam um comando, use a ponte mcp-remote mostrada acima.

Instalação local (npx)

Prefere executá-lo você mesmo? O servidor também está publicado no npm e roda via stdio.

Claude Code

Para todos os projetos (global, recomendado):

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

Para apenas o projeto atual:

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

Claude Desktop

Adicione ao seu claude_desktop_config.json:

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

Cursor

Crie ou edite .cursor/mcp.json na raiz do seu projeto (ou ~/.cursor/mcp.json para global):

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

Windsurf

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

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

VS Code + GitHub Copilot

Crie ou edite .vscode/mcp.json no seu workspace:

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

Outras ferramentas compatíveis com MCP

Para qualquer outra ferramenta que suporte MCP (Cline, Continue, Amazon Q, Zed, etc.), configure-a para executar:

npx -y @amcharts/amcharts5-mcp

Executar localmente (para desenvolvimento)

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

Ferramentas Disponíveis

Ferramenta	Descrição
get_core_reference	Obtém a documentação principal do amCharts 5 — configuração, temas, cores, eventos, armadilhas comuns
get_chart_reference	Obtém a referência completa de um tipo de gráfico (por exemplo, "pie", "sankey", "xy")
list_chart_types	Lista todos os tipos de gráfico disponíveis e suas palavras-chave
search_docs	Pesquisa nos documentos de referência da skill por palavra-chave (scope: "all" inclui a documentação completa, a referência da API e os exemplos)
search_all	Pesquisa em tudo — documentos da skill, documentação completa e exemplos de código
get_doc	Obtém uma página completa de documentação (por exemplo, "charts/xy-chart/axes", "concepts/events")
get_section	Obtém uma seção específica de um arquivo de referência por título
get_quick_start	Obtém um modelo mínimo funcional para qualquer tipo de gráfico
list_examples	Navega por todos os mais de 290 exemplos, opcionalmente filtrados por categoria
get_example	Obtém o código completo de um exemplo específico
get_api_reference	Obtém a referência da API de uma classe, interface ou função — configurações com seus padrões, eventos, herança e a linha de importação
list_geodata	Encontra arquivos de mapa (geodados) — mundo, continentes, países, pacotes regionais e os pacotes de distritos congressuais dos EUA por Congresso — com o caminho CDN, o global de script e o import ES de cada arquivo

Exemplo de Uso

Depois de conectado, seu assistente de IA pode:

• "Crie um gráfico de pizza para mim" → a IA chama get_quick_start("pie") e adapta o modelo
• "Como formato os rótulos do eixo de datas?" → a IA chama search_all("date axis label format")
• "Mostre-me o exemplo do diagrama de Sankey" → a IA chama get_example("examples/flow/sankey-diagram")
• "Quais configurações o XYChart suporta?" → a IA chama get_doc("reference/xychart")
• "Como integro com React?" → a IA chama get_doc("getting-started/integrations/react"), que cobre o pacote @amcharts/amcharts5-react
• "Quais tipos de gráfico estão disponíveis?" → a IA chama list_chart_types()
• "Mapeie os distritos congressuais atuais dos EUA" → a IA chama list_geodata("congressional whole country")

Conteúdo

O servidor inclui mais de 1.800 documentos:

• Mais de 160 páginas de documentação — primeiros passos, guias de gráficos, conceitos (temas, eventos, adaptadores, vinculação de dados, animações, acessibilidade, etc.) e guias de integração de frameworks para os pacotes React, Vue, Angular, Svelte e React Native do amCharts (com Next.js, Nuxt, SvelteKit, React Router e Remix 3)
• Mais de 290 exemplos de código — demonstrações funcionais em 16 categorias, incluindo coluna/barra, linha/área, pizza/rosca, mapas, hierarquia, fluxo, radar/polar, stock, medidores, Gantt, linha do tempo e mais
• Mais de 1.300 páginas de referência da API — cada classe, interface e função da biblioteca amCharts 5, geradas a partir das tipagens da versão: configurações com seus padrões reais (incluindo regras de tema), eventos, propriedades, campos de itens de dados, a cadeia de herança e a linha de importação
• Mais de 670 entradas de geodados — todos os mapas em @amcharts/amcharts5-geodata, para list_geodata
• Referência de skill curada — modelos de início rápido e guias específicos de gráficos da amCharts 5 AI Skill

Segurança

• Ferramentas somente leitura. Todas as ferramentas leem a documentação do amCharts incluída e retornam texto. Nenhuma ferramenta grava arquivos, executa comandos ou busca URLs.
• O endpoint hospedado não tem autenticação, por design. https://mcp.amcharts.com/mcp serve a mesma documentação pública do amcharts.com. Não há contas, chaves de API, dados de usuário ou operações de escrita por trás dele.
  • Ele roda no Cloudflare Workers.
  • O estado da sessão MCP é mantido em um Durable Object, conforme exigido pelo framework de agentes MCP. Ele é excluído quando a sessão termina, ou 24 horas após sua última requisição.
  • Os logs por requisição (logs de invocação do Workers) estão desativados. Apenas mensagens de erro são registradas, e elas não contêm argumentos de ferramentas. Veja "Privacidade" abaixo.
• Instalação local. O pacote npm roda via stdio na sua máquina e lê apenas o conteúdo incluído nele; não faz requisições de rede. Suas únicas dependências de tempo de execução são @modelcontextprotocol/sdk e zod.
• Scripts do mantenedor. Os scripts em scripts/ (os scrapers de demonstração e documentação, o gerador de referência da API) não fazem parte do pacote npm e nunca rodam no servidor.
• Relatar uma vulnerabilidade: https://www.amcharts.com/report-vulnerability/

Privacidade

Nem o servidor hospedado nem o pacote npm precisam de conta ou solicitam dados pessoais.

• Servidor hospedado (https://mcp.amcharts.com/mcp):
  • O que seu app de IA envia: uma frase de pesquisa, um tipo de gráfico, um caminho de documento. Eles são usados apenas para construir a resposta e não são registrados nem armazenados. Uma resposta é mantida no armazenamento da sessão apenas até ser entregue (para que um stream interrompido possa ser retomado) e depois é excluída.
  • Registro da sessão: quando um app de IA se conecta, o servidor mantém sua mensagem de inicialização MCP no armazenamento da sessão. Essa mensagem contém o que o app diz sobre si mesmo (seu nome e versão, e o que mais ele colocar ali), a versão do protocolo e as capacidades MCP do app. Todo o armazenamento da sessão é excluído quando o app encerra a sessão, ou 24 horas após sua última requisição.
  • Logs: o servidor não mantém logs de requisições (os logs de invocação do Workers estão desativados). Ele roda no Cloudflare Workers, e a Cloudflare processa cada requisição, incluindo seu endereço IP, para entregá-la. Mensagens de erro e aviso são registradas e mantidas por até 7 dias; elas não contêm conteúdos de requisição nem argumentos de ferramentas.
• Pacote npm: ele roda no seu computador via stdio e não envia nada para o amCharts nem para ninguém mais.
• Política e dúvidas: veja a política de privacidade do amCharts, ou escreva para contact@amcharts.com.

Licença

MIT