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 연결

Related MCP server: who-will-notify-mcp

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 학습

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