MCP Server Chart
- 추천0
- GitHub 별4.4K
- 디자인라이선스MIT
AntV로 AI가 차트 · 도표 26종 이상을 만들어 주는 MCP 서버. 막대 · 선 · 파이 · 마인드맵 · 피벗 표까지 만들어요. MIT
설치 방법은 설치 탭에 정리했어요.
설명
MCP Server Chart
AntV로 차트를 만들어 주는 Model Context Protocol 서버입니다. 이 MCP 서버로 _차트 생성_과 _데이터 분석_을 할 수 있습니다.

TypeScript로 만든 MCP 서버로, 차트 생성 기능을 제공합니다. MCP 도구를 통해 여러 종류의 차트를 만들 수 있습니다. Dify에서도 쓸 수 있습니다.
📋 차례
- ✨ 기능
- 🤖 사용법
- 🎨 스킬 사용법
- 🚰 SSE 또는 Streamable 전송으로 실행하기
- 🎮 CLI 옵션
- ⚙️ 환경 변수
- VIS_REQUEST_SERVER
- SERVICE_ID
- DISABLED_TOOLS
- 📠 개인 서버 배포
- 🗺️ 생성 기록
- 🎛️ 도구 거르기
- 🔨 개발
- 📄 라이선스
✨ 기능
지금 26종 이상의 차트를 지원합니다.

generate_area_chart:영역(area)차트를 만듭니다. 연속하는 독립 변수에 따른 데이터의 추세를 보여 주며, 전체 추세를 살펴보기 좋습니다.generate_bar_chart:가로 막대(bar)차트를 만듭니다. 서로 다른 범주의 값을 비교하며, 가로 비교에 알맞습니다.generate_boxplot_chart:상자 그림(boxplot)을 만듭니다. 중앙값, 사분위수, 이상치를 포함한 데이터 분포를 보여 줍니다.generate_column_chart:세로 막대(column)차트를 만듭니다. 서로 다른 범주의 값을 비교하며, 세로 비교에 알맞습니다.generate_district_map-행정 구역 지도(district-map)를 만듭니다. 행정 구역과 데이터 분포를 보여 줍니다.generate_dual_axes_chart:이중 축(dual-axes)차트를 만듭니다. 단위나 범위가 다른 두 변수 사이의 관계를 보여 줍니다.generate_fishbone_diagram:피시본(fishbone)다이어그램(이시카와 다이어그램이라고도 함)을 만듭니다. 문제의 근본 원인을 찾아 보여 줍니다.generate_flow_diagram:순서도(flowchart)를 만듭니다. 한 과정의 단계와 순서를 보여 줍니다.generate_funnel_chart:깔때기(funnel)차트를 만듭니다. 단계마다 데이터가 줄어드는 모습을 보여 줍니다.generate_histogram_chart:히스토그램(histogram)을 만듭니다. 데이터를 구간으로 나누고 각 구간의 데이터 수를 세어 분포를 보여 줍니다.generate_line_chart:선(line)차트를 만듭니다. 시간이나 다른 연속 변수에 따른 데이터의 추세를 보여 줍니다.generate_liquid_chart:액체(liquid)차트를 만듭니다. 데이터의 비율을 물이 찬 구의 모양으로 퍼센트로 보여 줍니다.generate_mind_map:마인드맵(mind-map)을 만듭니다. 생각의 흐름과 계층 정보를 보여 줍니다.generate_network_graph:네트워크(network)그래프를 만듭니다. 노드 사이의 관계와 연결을 보여 줍니다.generate_organization_chart:조직도(organizational)를 만듭니다. 조직의 구조와 구성원 사이의 관계를 보여 줍니다.generate_path_map-경로 지도(path-map)를 만듭니다. 관심 지점(POI)의 경로 계획 결과를 보여 줍니다.generate_pie_chart:원(pie)차트를 만듭니다. 데이터를 부채꼴로 나누어 각 부분의 비율을 보여 줍니다.generate_pin_map-핀 지도(pin-map)를 만듭니다. 관심 지점(POI)의 분포를 보여 줍니다.generate_radar_chart:방사형(radar)차트를 만듭니다. 여러 차원의 데이터를 레이더 모양으로 한꺼번에 보여 줍니다.generate_sankey_chart:생키(sankey)차트를 만듭니다. 서로 다른 노드 사이로 데이터가 흐르는 방향과 양을 생키 방식으로 보여 줍니다.generate_scatter_chart:분산형(scatter)차트를 만듭니다. 두 변수의 관계를 좌표계 위의 흩어진 점으로 보여 줍니다.generate_treemap_chart:트리맵(treemap)을 만듭니다. 계층 데이터를 사각형으로 보여 주며, 사각형 크기가 데이터의 값을 나타냅니다.generate_venn_chart:벤(venn)다이어그램을 만듭니다. 교집합, 합집합, 차집합을 포함한 집합 사이의 관계를 보여 줍니다.generate_violin_chart:바이올린(violin)그림을 만듭니다. 상자 그림과 밀도 그림의 특징을 합쳐 데이터 분포를 더 자세히 보여 줍니다.generate_word_cloud_chart:워드 클라우드(word-cloud)를 만듭니다. 텍스트 데이터에서 단어가 나온 빈도를 글자 크기로 보여 줍니다.generate_spreadsheet: 표 데이터를 보여 주는스프레드시트(spreadsheet)또는 피벗 테이블을 만듭니다. 'rows'나 'values' 필드를 주면 피벗 테이블(교차 집계)로, 아니면 일반 표로 그립니다.
💡 참고 위의 지리 시각화 차트 생성 도구는 AMap 서비스를 쓰며, 지금은 중국 안의 지도 생성만 지원합니다.
🤖 사용법
Claude, VSCode, Cline, Cherry Studio, Cursor 같은 데스크톱 앱에서 쓰려면 아래 MCP 서버 설정을 추가하세요. Mac 시스템은 다음과 같습니다.
{
"mcpServers": {
"mcp-server-chart": {
"command": "npx",
"args": ["-y", "@antv/mcp-server-chart"]
}
}
}
Windows 시스템은 다음과 같습니다.
{
"mcpServers": {
"mcp-server-chart": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@antv/mcp-server-chart"]
}
}
}
또한 aliyun, modelscope, glama.ai, smithery.ai 등에서 HTTP, SSE 프로토콜로 쓸 수도 있습니다.
🎨 스킬 사용법
Claude Code처럼 스킬을 지원하는 AI IDE를 쓴다면, chart-visualization 스킬로 가장 알맞은 차트 종류를 자동으로 골라 시각화를 만들 수 있습니다.
https://github.com/antvis/chart-visualization-skills의 스킬을 다음 명령으로 추가할 수 있습니다.
npx skills add antvis/chart-visualization-skills
그런 다음 데이터를 주거나 원하는 시각화를 설명하세요. 스킬이 25종 이상의 차트 중에서 알맞은 것을 골라 차트를 만들어 줍니다.
🚰 SSE 또는 Streamable 전송으로 실행하기
바로 실행하기
패키지를 전역으로 설치합니다.
npm install -g @antv/mcp-server-chart
원하는 전송 방식으로 서버를 실행합니다.
# For SSE transport (default endpoint: /sse)
mcp-server-chart --transport sse
# For Streamable transport with custom endpoint
mcp-server-chart --transport streamable
그러면 다음 주소로 서버에 접속할 수 있습니다.
- SSE 전송:
http://localhost:1122/sse - Streamable 전송:
http://localhost:1122/mcp
Docker로 배포하기
docker 폴더로 들어갑니다.
cd docker
docker-compose로 배포합니다.
docker compose up -d
그러면 다음 주소로 서버에 접속할 수 있습니다.
- SSE 전송:
http://localhost:1123/sse - Streamable 전송:
http://localhost:1122/mcp
🎮 CLI 옵션
MCP 서버를 실행할 때 다음 CLI 옵션도 쓸 수 있습니다. -H로 CLI를 실행하면 명령 옵션이 나옵니다.
MCP Server Chart CLI
Options:
--transport, -t Specify the transport protocol: "stdio", "sse", or "streamable" (default: "stdio")
--host, -h Specify the host for SSE or streamable transport (default: localhost)
--port, -p Specify the port for SSE or streamable transport (default: 1122)
--endpoint, -e Specify the endpoint for the transport:
- For SSE: default is "/sse"
- For streamable: default is "/mcp"
--help, -H Show this help message
⚙️ 환경 변수
| 변수 | 설명 | 기본값 | 예시 |
|---|---|---|---|
VIS_REQUEST_SERVER | 개인 서버 배포용 사용자 지정 차트 생성 서비스 주소 | https://antv-studio.alipay.com/api/gpt-vis | https://your-server.com/api/chart |
SERVICE_ID | 차트 생성 기록용 서비스 식별자 | - | your-service-id-123 |
DISABLED_TOOLS | 끌 도구 이름의 쉼표 구분 목록 | - | generate_fishbone_diagram,generate_mind_map |
📠 개인 서버 배포
MCP Server Chart는 기본으로 무료 차트 생성 서비스를 제공합니다. 개인 서버 배포가 필요한 사용자는 VIS_REQUEST_SERVER로 자기만의 차트 생성 서비스를 지정해 볼 수 있습니다.
{
"mcpServers": {
"mcp-server-chart": {
"command": "npx",
"args": ["-y", "@antv/mcp-server-chart"],
"env": {
"VIS_REQUEST_SERVER": "<YOUR_VIS_REQUEST_SERVER>"
}
}
}
}
AntV의 프로젝트 GPT-Vis-SSR로 사설 환경에 HTTP 서비스를 배포한 뒤, 그 URL 주소를 환경 변수 VIS_REQUEST_SERVER로 넘기면 됩니다.
- 메서드:
POST - 매개변수: 렌더링을 위해
GPT-Vis-SSR로 전달되는 값입니다. 예:{ "type": "line", "data": [{ "time": "2025-05", "value": 512 }, { "time": "2025-06", "value": 1024 }] }. - 반환: HTTP 서비스가 돌려주는 객체입니다.
- success:
boolean차트 이미지를 성공적으로 만들었는지 여부. - resultObj:
string차트 이미지 주소. - errorMessage:
stringsuccess = false일 때 돌려주는 오류 메시지.
- success:
💡 참고 개인 서버 배포 방식은 지금 지리 시각화 차트 생성을 지원하지 않습니다. 해당하는 도구는
geographic-district-map,geographic-path-map,geographic-pin-map3개입니다.
🗺️ 생성 기록
기본적으로 사용자가 결과를 직접 저장해야 하지만, 차트 생성 기록을 볼 수 있는 서비스도 제공합니다. 이를 쓰려면 서비스 식별자를 직접 만들어 설정해야 합니다.
Alipay로 QR을 스캔해 미니 프로그램을 열고 개인 서비스 식별자를 만드세요(아래 「My」 메뉴를 누르고, 「My Services」 페이지로 들어가, 「Generate」 단추를 누르고, 성공하면 「Copy」 단추를 누릅니다).

다음으로 MCP 서버 설정에 SERVICE_ID 환경 변수를 추가해야 합니다. 예를 들어 Mac 설정은 다음과 같습니다(Windows 시스템은 env 변수만 추가하면 됩니다).
{
"mcpServers": {
"AntV Map": {
"command": "npx",
"args": ["-y", "@antv/mcp-server-chart"],
"env": {
"SERVICE_ID": "***********************************"
}
}
}
}
MCP 서버 설정을 바꾼 뒤에는 AI 클라이언트 앱을 다시 시작하고, MCP 서버에 잘 시작되어 연결됐는지 다시 확인해야 합니다. 그런 다음 지도를 다시 만들어 보세요. 생성에 성공하면 미니 프로그램의 「My Map」 페이지에서 지도 생성 기록을 볼 수 있습니다.
🎛️ 도구 거르기
DISABLED_TOOLS 환경 변수로 특정 차트 생성 도구를 끌 수 있습니다. 어떤 도구가 쓰는 MCP 클라이언트와 호환 문제가 있거나 쓸 수 있는 기능을 제한하고 싶을 때 쓸모 있습니다.
{
"mcpServers": {
"mcp-server-chart": {
"command": "npx",
"args": ["-y", "@antv/mcp-server-chart"],
"env": {
"DISABLED_TOOLS": "generate_fishbone_diagram,generate_mind_map"
}
}
}
}
거르는 데 쓸 수 있는 도구 이름은 위의 「✨ 기능」을 보세요.
🔨 개발
의존성을 설치합니다.
npm install
서버를 빌드합니다.
npm run build
MCP 서버를 시작합니다.
npm run start
SSE 전송으로 MCP 서버를 시작합니다.
node build/index.js -t sse
Streamable 전송으로 MCP 서버를 시작합니다.
node build/index.js -t streamable