Install
uvx --from charted[mcp] charted-mcp누구에게 맞나
에이전트가 SVG 또는 PNG를 바로 내길 원하고 charted를 먼저 프로젝트 의존성에 넣고 싶지 않을 때. 공식 MCP 경로는 uvx로 MCP extra가 붙은 charted를 일회성 환경에서 띄우고 stdio로 제공한다. 핵심 라이브러리는 런타임 의존성이 없다. PNG 내보내기와 MCP는 선택 extra라 의존성을 가져오지만 바닥은 순수 Python이다.
먼저 어떤 차트 종류와 테마가 있는지 물은 뒤 생성 여부를 결정할 때 맞다. 공식은 15종이라고 쓴다. 첫 시도에서 펼쳐지지 않은 pip 설치 설명을 쓰지 마라.
공식 저장소는 한 줄:
https://github.com/marzukia/charted
도구 세부 앵커는 한 줄:
https://github.com/marzukia/charted#mcp-server-ai-agent-integration
3분 만에 첫 시도
이 uvx 명령만 쓴다:
uvx --from charted[mcp] charted-mcp
Claude Code 등록은:
claude mcp add charted -- uvx --from charted[mcp] charted-mcp
Cursor, Cline 및 다른 클라이언트는 같은 명령을 각 MCP 설정에 넣는다. 주 경로로 프로젝트 안 가상환경을 함께 설치하지 마라.
전제: 이 기기에 uvx가 있다. uvx는 charted의 MCP extra를 일회성 환경으로 가져온다.
설정 위치: Claude Code는 위의 add를 쓰고, 다른 클라이언트의 MCP server 설정에 같은 uvx 명령을 넣어 stdio로 시작한다.
위험 낮은 첫 단계: list_chart_types를 호출해 차트 종류를 받는다. 또는 list_themes로 테마를 받는다. 둘 다 목록이며 파일을 만들지 않는다. 성공 신호는 종류 또는 테마가 돌아오는 것이다. 그 목록을 네트워크 없음으로 읽지 마라. uvx는 여전히 패키지를 받고 로컬 프로세스를 띄운다.
목록이 정상이면 그때 그림을 고려한다. create_chart는 차트를 만들고 chart_from_csv는 CSV에서 그린다. 그림은 에이전트 쪽에 SVG 또는 PNG를 만들며 읽기 전용이 아니다. 호출 전에 데이터를 이 일회성 환경에 넘겨도 되는지 확인하고, 호출 후에는 차트를 얻은 것을 성공 신호로 삼는다. 공식은 디스크 출력 경로와 취소 명령을 쓰지 않았다.
사용 사례
사례 1: 어떤 종류를 지원하는지 먼저 본다. list_chart_types를 호출한다. 테마가 필요하면 list_themes를 호출한다. 공식은 도구 이름만 주고 15종의 명단을 열거하지 않는다.
사례 2: 구조화 데이터나 CSV로 그린다. create_chart로 차트를 만들거나 chart_from_csv로 CSV에서 만든다. 출력은 SVG 또는 PNG일 수 있다. PNG는 MCP와 같이 opt-in extra다. 공식은 필드 이름, 테마 이름, CSV 열 규칙을 주지 않는다.
사용 한계
주 경로는 uvx --from charted[mcp] charted-mcp이며 pip 경로를 첫 시도로 보지 마라. 핵심의 의존성 없음이 MCP extra의 의존성 없음은 아니다. 이 페이지는 create_chart, list_chart_types, list_themes, chart_from_csv만 거명한다. 그림에는 부작용이 있다. readOnlyHint는 제로 위험이 아니다. 공식은 Claude skill도 언급하지만 이 발췌에는 skill 설치 단계가 없다.