MCP Data Analyst

Python과 Pandas로 구축된 경량 Model Context Protocol(MCP) 서버로, 재사용 가능한 데이터 분석 기능을 MCP 도구로 노출합니다.

개요

이 프로젝트는 MCP 호환 클라이언트가 표준화된 MCP 서버를 통해 외부 데이터 분석 도구를 검색하고 호출하는 방법을 보여줍니다.

서버는 샘플 판매 CSV 데이터셋을 분석하며 다섯 가지 도구를 노출합니다:

• dataset_info - 데이터셋 차원과 열 이름 반환

• dataset_summary - 기술 통계 반환

• missing_values - 누락 값 감지

• sales_by_region - 지역별 판매 기록 필터링

• column_analysis - 숫자 열에 대한 통계 계산

Related MCP server: Claude Data Buddy

아키텍처

User / AI Host | v MCP Client | v MCP Server | v MCP Tools | v Python + Pandas | v Sales CSV Dataset

프로젝트 구조

mcp-data-analyst/ ├── data/ │ └── sample_sales.csv ├── tests/ │ └── test_analysis.py ├── tools/ │ ├── init.py │ ├── analysis_tools.py │ └── csv_tools.py ├── server.py ├── requirements.txt ├── pytest.ini ├── .gitignore └── README.md

기술 스택

• Python

• Model Context Protocol (MCP)

• Pandas

• Pytest

• MCP Inspector

설치

가상 환경을 생성하고 활성화합니다.

Windows PowerShell:

python -m venv venv
.\venv\Scripts\Activate.ps1