# choco-club-mcp

초코파이썬 AI-MCP 최종 프로젝트

학교 동아리 데이터를 조회·검색하고, 학생의 관심도에 맞는 동아리를 추천하는 Python 기반 MCP(Model Context Protocol) 프로젝트입니다.

이 프로젝트에서는 Python으로 만든 동아리 서비스를 MCP Tool로 공개하고, 일반 MCP Client와 Claude Desktop에서 사용하는 전체 과정을 학습합니다.

## 1. 프로젝트 목표

다음 기능을 MCP Tool로 제공합니다.

- 전체 동아리 조회
- 동아리 이름 및 분야 검색
- 학생의 관심도에 따른 동아리 추천
- 전체 동아리 통계 조회
- MCP Client를 이용한 Tool 호출
- Claude Desktop과 로컬 MCP Server 연결

## 2. 주요 파일

- `clubs.csv`: 동아리 데이터
- `club_service.py`: 동아리 조회·검색·추천·통계 기능
- `server.py`: Python 기능을 MCP Tool로 공개
- `client.py`: MCP Server에 연결하여 Tool 호출
- `pyproject.toml`: 프로젝트 정보와 패키지 설정
- `uv.lock`: 패키지 버전을 기록한 파일

## 3. 개발 환경

- 운영체제: Windows 10 또는 Windows 11
- Python: 3.13.15 권장 (3.12이상)
- 패키지 관리자: uv
- MCP Client: Claude Desktop
- MCP 통신 방식: stdio

## 4. chocopython-ai-mcp 학습

- 학습 후 완성되는 소스코드입니다.