amCharts 5 MCP Server

amCharts 5 MCP Server

Một máy chủ MCP (Model Context Protocol) cho phép trợ lý AI truy cập theo yêu cầu vào toàn bộ cơ sở kiến thức amCharts 5: hơn 160 trang tài liệu, hơn 290 ví dụ mã và hơn 1.300 trang tham chiếu API.

Hoạt động với Claude Code, Claude Desktop, Cursor, Windsurf, VS Code + GitHub Copilot và mọi công cụ AI tương thích MCP khác.

Tại sao?

Thay vì nạp toàn bộ tài liệu tham chiếu amCharts vào cửa sổ ngữ cảnh của AI, máy chủ MCP cho phép AI truy vấn chính xác những gì nó cần — tham chiếu cho một loại biểu đồ cụ thể, một ví dụ mã hoặc một tra cứu API. Điều này mang lại câu trả lời tốt hơn với ít lãng phí ngữ cảnh hơn.

Bắt đầu nhanh

Cách dễ nhất là dùng máy chủ được lưu trữ — không cần cài đặt, chỉ cần thêm một URL. Muốn tự chạy? Xem Cài đặt cục bộ bên dưới.

Được lưu trữ (không cần cài đặt) — khuyến nghị

Trỏ ứng dụng AI của bạn tới:

https://mcp.amcharts.com/mcp

Claude Code

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

Claude Desktop / claude.ai — Settings → Connectors → Add custom connector, sau đó dán 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 có bật connectors/chế độ nhà phát triển) — Settings → Connectors → Add custom connector, sau đó dán https://mcp.amcharts.com/mcp.

Cline (tiện ích mở rộng VS Code) — mở bảng MCP Servers → Remote Servers, dán https://mcp.amcharts.com/mcp, hoặc thêm vào JSON cài đặt MCP của nó:

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

Các ứng dụng chỉ hỗ trợ máy chủ cục bộ (stdio) (ví dụ Zed, Continue, Amazon Q Developer) — cầu nối tới URL được lưu trữ bằng mcp-remote. Dùng lệnh này làm lệnh chạy của máy chủ trong cấu hình của ứng dụng:

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

Ví dụ, trong cấu hình kiểu command/args:

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

Mọi ứng dụng MCP khác chấp nhận URL máy chủ từ xa cũng đều dùng được — hãy dùng điểm cuối /mcp (Streamable HTTP) hoặc /sse (SSE cũ). Với các ứng dụng chỉ nhận URL nhưng vẫn yêu cầu một lệnh, hãy dùng cầu nối mcp-remote như trên.

Cài đặt cục bộ (npx)

Muốn tự chạy? Máy chủ cũng được phát hành trên npm và chạy qua stdio.

Claude Code

Cho tất cả dự án (toàn cục, khuyến nghị):

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

Chỉ cho dự án hiện tại:

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

Claude Desktop

Thêm vào claude_desktop_config.json của bạn:

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

Cursor

Tạo hoặc sửa .cursor/mcp.json trong thư mục gốc dự án (hoặc ~/.cursor/mcp.json cho toàn cục):

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

Windsurf

Sửa ~/.codeium/windsurf/mcp_config.json:

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

VS Code + GitHub Copilot

Tạo hoặc sửa .vscode/mcp.json trong workspace của bạn:

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

Các công cụ tương thích MCP khác

Với mọi công cụ khác hỗ trợ MCP (Cline, Continue, Amazon Q, Zed, v.v.), hãy cấu hình để chạy:

npx -y @amcharts/amcharts5-mcp

Chạy cục bộ (để phát triển)

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

Các công cụ có sẵn

Công cụ	Mô tả
get_core_reference	Lấy tài liệu amCharts 5 cốt lõi — thiết lập, chủ đề, màu sắc, sự kiện, các lỗi thường gặp
get_chart_reference	Lấy tham chiếu đầy đủ cho một loại biểu đồ (ví dụ "pie", "sankey", "xy")
list_chart_types	Liệt kê tất cả loại biểu đồ có sẵn và từ khóa của chúng
search_docs	Tìm kiếm tài liệu tham chiếu kỹ năng theo từ khóa (scope: "all" thêm toàn bộ tài liệu, tham chiếu API và ví dụ)
search_all	Tìm kiếm trên mọi thứ — tài liệu kỹ năng, tài liệu đầy đủ và ví dụ mã
get_doc	Lấy một trang tài liệu đầy đủ (ví dụ "charts/xy-chart/axes", "concepts/events")
get_section	Lấy một phần cụ thể từ tệp tham chiếu theo tiêu đề
get_quick_start	Lấy mẫu tối giản hoạt động được cho bất kỳ loại biểu đồ nào
list_examples	Duyệt tất cả hơn 290 ví dụ, có thể lọc theo danh mục
get_example	Lấy toàn bộ mã cho một ví dụ cụ thể
get_api_reference	Lấy tham chiếu API cho một lớp, giao diện hoặc hàm — các thiết lập với giá trị mặc định, sự kiện, kế thừa và dòng import
list_geodata	Tìm các tệp bản đồ (geodata) — thế giới, châu lục, quốc gia, gói khu vực và các gói khu vực bầu cử quốc hội Hoa Kỳ theo từng Quốc hội — kèm đường dẫn CDN, biến toàn cục script và import ES của từng tệp

Ví dụ sử dụng

Sau khi kết nối, trợ lý AI của bạn có thể:

• "Tạo cho tôi một biểu đồ tròn" → AI gọi get_quick_start("pie") và điều chỉnh mẫu
• "Làm sao định dạng nhãn trục ngày tháng?" → AI gọi search_all("date axis label format")
• "Cho tôi xem ví dụ biểu đồ Sankey" → AI gọi get_example("examples/flow/sankey-diagram")
• "XYChart hỗ trợ những thiết lập nào?" → AI gọi get_doc("reference/xychart")
• "Làm sao tích hợp với React?" → AI gọi get_doc("getting-started/integrations/react"), bao gồm gói @amcharts/amcharts5-react
• "Có những loại biểu đồ nào?" → AI gọi list_chart_types()
• "Vẽ bản đồ các khu vực bầu cử quốc hội Hoa Kỳ hiện tại" → AI gọi list_geodata("congressional whole country")

Nội dung

Máy chủ bao gồm hơn 1.800 tài liệu:

• Hơn 160 trang tài liệu — bắt đầu, hướng dẫn biểu đồ, khái niệm (chủ đề, sự kiện, adapter, liên kết dữ liệu, hoạt ảnh, khả năng truy cập, v.v.) và hướng dẫn tích hợp framework cho các gói React, Vue, Angular, Svelte và React Native của amCharts (với Next.js, Nuxt, SvelteKit, React Router và Remix 3)
• Hơn 290 ví dụ mã — bản demo hoạt động được trên 16 danh mục bao gồm cột/thanh, đường/vùng, tròn/vành khuyên, bản đồ, phân cấp, luồng, radar/cực, chứng khoán, đồng hồ đo, Gantt, dòng thời gian, v.v.
• Hơn 1.300 trang tham chiếu API — mọi lớp, giao diện và hàm trong thư viện amCharts 5, được tạo từ typings của bản phát hành: các thiết lập với giá trị mặc định thực tế (bao gồm quy tắc chủ đề), sự kiện, thuộc tính, trường mục dữ liệu, chuỗi kế thừa và dòng import
• Hơn 670 mục geodata — mọi bản đồ trong @amcharts/amcharts5-geodata, cho list_geodata
• Tài liệu tham chiếu kỹ năng được tuyển chọn — mẫu bắt đầu nhanh và hướng dẫn theo từng loại biểu đồ từ amCharts 5 AI Skill

Bảo mật

• Công cụ chỉ đọc. Mọi công cụ đều đọc tài liệu amCharts đi kèm và trả về văn bản. Không công cụ nào ghi tệp, chạy lệnh hay tải URL.
• Điểm cuối được lưu trữ không có xác thực, theo thiết kế. https://mcp.amcharts.com/mcp phục vụ cùng tài liệu công khai như amcharts.com. Không có tài khoản, khóa API, dữ liệu người dùng hay thao tác ghi nào phía sau nó.
  • Nó chạy trên Cloudflare Workers.
  • Trạng thái phiên MCP được lưu trong Durable Object, theo yêu cầu của framework MCP agents. Nó bị xóa khi phiên kết thúc, hoặc 24 giờ sau yêu cầu cuối cùng.
  • Nhật ký theo từng yêu cầu (nhật ký gọi Workers) bị tắt. Chỉ các thông báo lỗi được ghi lại, và chúng không chứa đối số công cụ. Xem "Quyền riêng tư" bên dưới.
• Cài đặt cục bộ. Gói npm chạy qua stdio trên máy của bạn và chỉ đọc nội dung đi kèm trong đó; nó không thực hiện yêu cầu mạng nào. Các phụ thuộc runtime duy nhất của nó là @modelcontextprotocol/sdk và zod.
• Script của người bảo trì. Các script trong scripts/ (trình thu thập demo và tài liệu, trình tạo tham chiếu API) không thuộc gói npm và không bao giờ chạy trong máy chủ.
• Báo cáo lỗ hổng bảo mật: https://www.amcharts.com/report-vulnerability/

Quyền riêng tư

Cả máy chủ được lưu trữ lẫn gói npm đều không cần tài khoản hay yêu cầu dữ liệu cá nhân.

• Máy chủ được lưu trữ (https://mcp.amcharts.com/mcp):
  • Những gì ứng dụng AI của bạn gửi: một cụm từ tìm kiếm, một loại biểu đồ, một đường dẫn tài liệu. Chúng chỉ được dùng để tạo câu trả lời và không bị ghi lại hay lưu trữ. Một phản hồi chỉ được giữ trong bộ nhớ của phiên cho đến khi được gửi đi (để luồng bị ngắt có thể tiếp tục), sau đó bị xóa.
  • Bản ghi phiên: khi ứng dụng AI kết nối, máy chủ giữ thông điệp khởi tạo MCP của nó trong bộ nhớ của phiên. Thông điệp đó chứa những gì ứng dụng nói về chính nó (tên và phiên bản, và bất kỳ thứ gì khác nó đặt vào đó), phiên bản giao thức và các khả năng MCP của ứng dụng. Toàn bộ bộ nhớ của phiên bị xóa khi ứng dụng kết thúc phiên, hoặc 24 giờ sau yêu cầu cuối cùng.
  • Nhật ký: máy chủ không giữ nhật ký yêu cầu (nhật ký gọi Workers bị tắt). Nó chạy trên Cloudflare Workers, và Cloudflare xử lý từng yêu cầu, bao gồm địa chỉ IP của nó, để phân phối yêu cầu. Các thông báo lỗi và cảnh báo được ghi lại và giữ tối đa 7 ngày; chúng không chứa nội dung yêu cầu hay đối số công cụ.
• Gói npm: nó chạy trên máy tính của bạn qua stdio và không gửi gì tới amCharts hay bất kỳ ai khác.
• Chính sách và câu hỏi: xem chính sách quyền riêng tư của amCharts, hoặc gửi email tới contact@amcharts.com.

Giấy phép

MIT