amCharts 5 MCP Server

amCharts 5 MCP Sunucusu

AI asistanlarına, eksiksiz amCharts 5 bilgi tabanına isteğe bağlı erişim sağlayan bir MCP (Model Bağlam Protokolü) sunucusu: 140'tan fazla dokümantasyon sayfası, 280'den fazla kod örneği ve 1.000'den fazla sınıf API referansı.

Claude Code, Claude Desktop, Cursor, Windsurf, VS Code + GitHub Copilot ve diğer MCP uyumlu AI araçlarıyla çalışır.

Neden?

amCharts referansının tamamını AI'nın bağlam penceresine yüklemek yerine, MCP sunucusu AI'nın tam olarak ihtiyaç duyduğu şeyi sorgulamasına olanak tanır — belirli bir grafik türü referansı, bir kod örneği veya bir API araması. Bu, daha az bağlam israfıyla daha iyi yanıtlar anlamına gelir.

Hızlı Başlangıç

En kolay yol barındırılan sunucudur — kurulum yok, sadece bir URL ekleyin. Kendiniz çalıştırmayı mı tercih edersiniz? Aşağıdaki Yerel kurulum bölümüne bakın.

Barındırılan (kurulum yok) — önerilir

AI istemcinizi şu adrese yönlendirin:

https://mcp.amcharts.com/mcp

Claude Code

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

Claude Desktop / claude.ai — Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle, ardından https://mcp.amcharts.com/mcp adresini yapıştırın.

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 (Bağlayıcılar/geliştirici modu etkinleştirilmiş Plus/Pro/Enterprise) — Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle, ardından https://mcp.amcharts.com/mcp adresini yapıştırın.

Cline (VS Code uzantısı) — MCP Sunucuları panelini açın → Uzak Sunucular, https://mcp.amcharts.com/mcp adresini yapıştırın veya MCP ayarları JSON'una ekleyin:

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

Yalnızca yerel (stdio) sunucuları destekleyen istemciler (örn. Zed, Continue, Amazon Q Developer) — barındırılan URL'ye mcp-remote ile köprü kurun. Bunu, istemcinin yapılandırmasında sunucunun çalıştırma komutu olarak kullanın:

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

Örneğin, command/args tarzı bir yapılandırmada:

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

Uzak bir sunucu URL'sini kabul eden diğer tüm MCP istemcileri de çalışır — /mcp uç noktasını (Akışkan HTTP) veya /sse (eski SSE) kullanın. Hâlâ bir komut bekleyen yalnızca URL istemcileri için yukarıda gösterilen mcp-remote köprüsünü kullanın.

Yerel kurulum (npx)

Kendiniz çalıştırmayı mı tercih edersiniz? Sunucu ayrıca npm'de yayınlanır ve stdio üzerinden çalışır.

Claude Code

Tüm projeler için (genel, önerilir):

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

Yalnızca mevcut proje için:

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

Claude Desktop

claude_desktop_config.json dosyanıza ekleyin:

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

Cursor

Proje kökünüzde (veya genel için ~/.cursor/mcp.json) .cursor/mcp.json oluşturun veya düzenleyin:

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

Windsurf

~/.codeium/windsurf/mcp_config.json dosyasını düzenleyin:

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

VS Code + GitHub Copilot

Çalışma alanınızda .vscode/mcp.json oluşturun veya düzenleyin:

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

Diğer MCP uyumlu araçlar

MCP'yi destekleyen diğer tüm araçlar için (Cline, Continue, Amazon Q, Zed, vb.), çalıştırmak üzere yapılandırın:

npx -y @amcharts/amcharts5-mcp

Yerel olarak çalıştırma (geliştirme için)

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

Mevcut Araçlar

Araç	Açıklama
get_core_reference	Temel amCharts 5 dokümanlarını alın — kurulum, temalar, renkler, olaylar, yaygın tuzaklar
get_chart_reference	Bir grafik türü için tam referans alın (örn. "pie", "sankey", "xy")
list_chart_types	Mevcut tüm grafik türlerini ve anahtar kelimelerini listeleyin
search_docs	Beceri referans dokümanlarında anahtar kelimeye göre arama yapın
search_all	Her şeyde arama yapın — beceri dokümanları, tam dokümantasyon ve kod örnekleri
get_doc	Tam bir dokümantasyon sayfası alın (örn. "charts/xy-chart/axes", "concepts/events")
get_section	Bir referans dosyasından başlığa göre belirli bir bölüm alın
get_quick_start	Herhangi bir grafik türü için minimal çalışan bir şablon alın
list_examples	İsteğe bağlı olarak kategoriye göre filtrelenmiş 283 örneğin tümüne göz atın
get_example	Belirli bir örnek için tam kodu alın

Örnek Kullanım

Bağlandıktan sonra AI asistanınız şunları yapabilir:

• "Bana bir pasta grafiği oluştur" → AI get_quick_start("pie") çağırır ve şablonu uyarlar
• "Tarih ekseni etiketlerini nasıl biçimlendiririm?" → AI search_all("date axis label format") çağırır
• "Sankey diyagramı örneğini göster" → AI get_example("examples/flow/sankey-diagram") çağırır
• "XYChart hangi ayarları destekliyor?" → AI get_doc("reference/xychart") çağırır
• "React ile nasıl entegre ederim?" → AI get_doc("getting-started/integrations/react") çağırır
• "Hangi grafik türleri mevcut?" → AI list_chart_types() çağırır

İçerik

Sunucu 1.500'den fazla belge içerir:

• 140'tan fazla dokümantasyon sayfası — başlangıç, grafik kılavuzları, kavramlar (temalar, olaylar, bağdaştırıcılar, veri bağlama, animasyonlar, erişilebilirlik, vb.) ve çerçeve entegrasyon kılavuzları (React, Angular, Vue, Next.js, Svelte ve daha fazlası)
• 280'den fazla kod örneği — sütun/çubuk, çizgi/alan, pasta/halka, haritalar, hiyerarşi, akış, radar/kutupsal, hisse senedi, göstergeler, Gantt, zaman çizelgesi ve daha fazlasını içeren 16 kategoride çalışan demolar
• 1.000'den fazla sınıf API referansı — amCharts 5 kütüphanesindeki her sınıf, ayarları, özellikleri, yöntemleri, olayları ve kalıtım zinciriyle birlikte
• Seçilmiş beceri referansı — amCharts 5 AI Becerisinden hızlı başlangıç şablonları ve grafiğe özel kılavuzlar

Lisans

MIT