amCharts 5 MCP Server

amCharts 5 MCP Server

Yapay zeka asistanlarına amCharts 5 bilgi tabanının tamamına isteğe bağlı erişim sağlayan bir MCP (Model Context Protocol) sunucusu: 160+ dokümantasyon sayfası, 290+ kod örneği ve 1.300+ API referans sayfası.

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

Neden?

MCP sunucusu, amCharts referansının tamamını yapay zekanın bağlam penceresine yüklemek yerine, yapay zekanı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

Yapay zeka 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 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 yapıştırın.

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

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

Yalnızca yerel (stdio) sunucuları destekleyen istemciler (ör. Zed, Continue, Amazon Q Developer) — mcp-remote ile barındırılan URL'ye köprü kurun. İstemcinin yapılandırmasında sunucunun çalıştırma komutu olarak bunu 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 sunucu URL'si kabul eden diğer tüm MCP istemcileri de çalışır — /mcp uç noktasını (Streamable HTTP) veya /sse (eski SSE) kullanın. Hâlâ bir komut bekleyen yalnızca URL kabul eden istemciler 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ınlanmıştı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 geçerli 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 .cursor/mcp.json dosyasını oluşturun veya düzenleyin (genel için ~/.cursor/mcp.json):

{
  "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 dosyasını 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 (Cline, Continue, Amazon Q, Zed vb.) için şunu çalıştıracak şekilde 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

Kullanılabilir Araçlar

Araç	Açıklama
get_core_reference	Temel amCharts 5 belgelerini alın — kurulum, temalar, renkler, olaylar, yaygın tuzaklar
get_chart_reference	Bir grafik türü için tam referansı alın (ör. "pie", "sankey", "xy")
list_chart_types	Kullanılabilir tüm grafik türlerini ve anahtar kelimelerini listeleyin
search_docs	Yetenek referans belgelerinde anahtar kelimeyle arama yapın (scope: "all" tam belgeleri, API referansını ve örnekleri ekler)
search_all	Her şey içinde arama yapın — yetenek belgeleri, tam dokümantasyon ve kod örnekleri
get_doc	Tam bir dokümantasyon sayfası alın (ör. "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	290+ örneğin tamamına göz atın, isteğe bağlı olarak kategoriye göre filtreleyin
get_example	Belirli bir örneğin tam kodunu alın
get_api_reference	Bir sınıf, arayüz veya fonksiyon için API referansını alın — varsayılan değerleriyle ayarlar, olaylar, kalıtım ve içe aktarma satırı
list_geodata	Harita (geodata) dosyalarını bulun — dünya, kıtalar, ülkeler, bölgesel paketler ve Kongre başına ABD kongre bölgesi paketleri — her dosyanın CDN yolu, script global değişkeni ve ES içe aktarımıyla

Örnek Kullanım

Bağlandıktan sonra, yapay zeka asistanınız şunları yapabilir:

• "Bana bir pasta grafik oluştur" → Yapay zeka get_quick_start("pie") çağırır ve şablonu uyarlar
• "Tarih ekseni etiketlerini nasıl biçimlendiririm?" → Yapay zeka search_all("date axis label format") çağırır
• "Bana Sankey diyagramı örneğini göster" → Yapay zeka get_example("examples/flow/sankey-diagram") çağırır
• "XYChart hangi ayarları destekler?" → Yapay zeka get_doc("reference/xychart") çağırır
• "React ile nasıl entegre ederim?" → Yapay zeka get_doc("getting-started/integrations/react") çağırır, bu da @amcharts/amcharts5-react paketini kapsar
• "Hangi grafik türleri mevcut?" → Yapay zeka list_chart_types() çağırır
• "Mevcut ABD kongre bölgelerini haritala" → Yapay zeka list_geodata("congressional whole country") çağırır

İçerik

Sunucu 1.800+ belge içerir:

• 160+ dokümantasyon sayfası — başlangıç, grafik kılavuzları, kavramlar (temalar, olaylar, adaptörler, veri bağlama, animasyonlar, erişilebilirlik vb.) ve amCharts'ın React, Vue, Angular, Svelte ve React Native paketleri için çerçeve entegrasyon kılavuzları (Next.js, Nuxt, SvelteKit, React Router ve Remix 3 ile birlikte)
• 290+ kod örneği — sütun/çubuk, çizgi/alan, pasta/halka, haritalar, hiyerarşi, akış, radar/polar, hisse senedi, göstergeler, Gantt, zaman çizelgesi ve daha fazlasını içeren 16 kategori genelinde çalışan demolar
• 1.300+ API referans sayfası — amCharts 5 kütüphanesindeki her sınıf, arayüz ve fonksiyon, sürümün tip tanımlarından oluşturulmuş: gerçek varsayılan değerleriyle ayarlar (tema kuralları dahil), olaylar, özellikler, veri öğesi alanları, kalıtım zinciri ve içe aktarma satırı
• 670+ geodata girdisi — @amcharts/amcharts5-geodata içindeki her harita, list_geodata için
• Özenle hazırlanmış yetenek referansı — amCharts 5 AI Skill kaynağından hızlı başlangıç şablonları ve grafiğe özgü kılavuzlar

Güvenlik

• Salt okunur araçlar. Her araç paketlenmiş amCharts dokümantasyonunu okur ve metin döndürür. Hiçbir araç dosya yazmaz, komut çalıştırmaz veya URL getirmez.
• Barındırılan uç noktada tasarım gereği kimlik doğrulama yoktur. https://mcp.amcharts.com/mcp, amcharts.com ile aynı genel dokümantasyonu sunar. Arka planda hesap, API anahtarı, kullanıcı verisi veya yazma işlemi yoktur.
  • Cloudflare Workers üzerinde çalışır.
  • MCP oturum durumu, MCP ajanları çerçevesinin gerektirdiği şekilde bir Durable Object içinde tutulur. Oturum sona erdiğinde veya son isteğinden 24 saat sonra silinir.
  • İstek başına günlükler (Workers çağrı günlükleri) kapalıdır. Yalnızca hata mesajları günlüğe kaydedilir ve bunlar araç argümanları içermez. Aşağıdaki "Gizlilik" bölümüne bakın.
• Yerel kurulum. npm paketi makinenizde stdio üzerinden çalışır ve yalnızca içinde paketlenmiş içeriği okur; hiçbir ağ isteği yapmaz. Tek çalışma zamanı bağımlılıkları @modelcontextprotocol/sdk ve zod'tür.
• Bakımcı betikleri. scripts/ içindeki betikler (demo ve doküman kazıyıcıları, API referans oluşturucu) npm paketinin parçası değildir ve sunucuda hiçbir zaman çalışmaz.
• Güvenlik açığı bildirimi: https://www.amcharts.com/report-vulnerability/

Gizlilik

Ne barındırılan sunucu ne de npm paketi bir hesap gerektirir veya kişisel veri ister.

• Barındırılan sunucu (https://mcp.amcharts.com/mcp):
  • Yapay zeka uygulamanızın gönderdikleri: bir arama ifadesi, bir grafik türü, bir belge yolu. Bunlar yalnızca yanıtı oluşturmak için kullanılır ve günlüğe kaydedilmez veya saklanmaz. Bir yanıt, yalnızca teslim edilene kadar (böylece kesilen bir akış devam edebilir) oturumun depolamasında tutulur, ardından silinir.
  • Oturum kaydı: bir yapay zeka uygulaması bağlandığında, sunucu MCP başlatma mesajını oturumun depolamasında tutar. Bu mesaj, uygulamanın kendisi hakkında söylediklerini (adı ve sürümü ve oraya koyduğu diğer her şey), protokol sürümünü ve uygulamanın MCP yeteneklerini içerir. Oturumun tüm depolaması, uygulama oturumu sona erdirdiğinde veya son isteğinden 24 saat sonra silinir.
  • Günlükler: sunucu hiçbir istek günlüğü tutmaz (Workers çağrı günlükleri kapalıdır). Cloudflare Workers üzerinde çalışır ve Cloudflare, her isteği teslim etmek için IP adresi dahil olmak üzere işler. Hata ve uyarı mesajları günlüğe kaydedilir ve 7 güne kadar saklanır; bunlar hiçbir istek içeriği veya araç argümanı içermez.
• npm paketi: bilgisayarınızda stdio üzerinden çalışır ve amCharts'a veya başka birine hiçbir şey göndermez.
• Politika ve sorular: amCharts gizlilik politikasına bakın veya contact@amcharts.com adresine yazın.

Lisans

MIT