CSV 분석 MCP 서버

제작: MEOK AI Labs | meok.ai

AI 에이전트를 위한 스프레드시트 및 CSV 분석 툴킷입니다. pandas를 기반으로 CSV 파일 로드, 데이터 필터링 및 쿼리, 통계 계산, 집계 생성, 피벗 테이블 구축, 차트용 데이터 내보내기 기능을 제공합니다.

도구

도구	설명
`load_csv`	분석을 위해 CSV 파일을 메모리에 로드
`query_data`	데이터 필터링, 열 선택, 정렬 및 슬라이싱
`describe_columns`	통계 요약 (평균, 표준편차, 사분위수, 상위 값 등)
`aggregate`	합계, 평균, 개수, 중앙값 등을 사용한 GROUP BY
`export_chart_data`	Chart.js / Plotly 호환 형식으로 데이터 내보내기
`pivot_table`	엑셀 스타일의 피벗 테이블

설치

pip install mcp pandas

사용법

서버 실행

python server.py

Claude Desktop 설정

{
  "mcpServers": {
    "csv-analytics": {
      "command": "python",
      "args": ["/path/to/csv-analytics-mcp/server.py"]
    }
  }
}

워크플로우

로드: CSV 파일 로드 (이름으로 메모리에 저장)
탐색: describe_columns 사용
쿼리: 필터, 정렬, 열 선택을 사용하여 쿼리
집계: 요약을 위해 aggregate 또는 pivot_table 사용
내보내기: 시각화를 위해 차트용 데이터 내보내기

예시 호출

CSV 파일 로드:

Tool: load_csv
Input: {"file_path": "/Users/me/data/sales.csv"}
Output: {"name": "sales", "rows": 15432, "columns": ["date", "product", "region", "amount", "quantity"], "dtypes": {"amount": "float64", "quantity": "int64"}}

열 설명:

Tool: describe_columns
Input: {"name": "sales"}
Output: {"columns": {"amount": {"mean": 245.32, "std": 89.10, "min": 5.00, "max": 2500.00, "median": 210.50}, "region": {"unique": 4, "top_values": {"North": 4210, "South": 3890, ...}}}}

필터를 사용한 쿼리:

Tool: query_data
Input: {"name": "sales", "filter_expr": "amount > 500 and region == 'North'", "sort_by": "amount", "ascending": false, "limit": 10}
Output: {"rows": [...], "row_count": 10, "total_rows": 312}

집계:

Tool: aggregate
Input: {"name": "sales", "group_by": ["region"], "metrics": {"amount": "sum", "quantity": "mean"}}
Output: {"rows": [{"region": "North", "amount": 1234567.89, "quantity": 12.3}, ...]}

피벗 테이블:

Tool: pivot_table
Input: {"name": "sales", "index": "region", "columns": "product", "values": "amount", "aggfunc": "sum"}
Output: {"pivot": {"North": {"Widget A": 50000, "Widget B": 32000}, "South": {"Widget A": 45000, ...}}}

차트용 내보내기:

Tool: export_chart_data
Input: {"name": "sales", "x_column": "region", "y_columns": ["amount"], "chart_type": "bar"}
Output: {"chart_type": "bar", "labels": ["North", "South", "East", "West"], "datasets": [{"label": "amount", "data": [1234567, 987654, ...]}]}

요금제

등급	제한	가격
무료	일일 30회 호출, 쿼리당 최대 500행	$0
프로	무제한 + Excel/Parquet 지원 + 다중 파일 조인	월 $9
엔터프라이즈	맞춤형 + 대용량 파일 스트리밍 + 예약 보고서	문의

라이선스

MIT

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

CSV Analytics MCP Server