SKT AI Summit Hackathon Pre-mission - AI Agent의 스트레스 관리와 휴식을 지원하는 MCP 서버
╔═══════════════════════════════════════════╗
║ ║
║ ██████╗██╗ ██╗██╗██╗ ██╗ ║
║ ██╔════╝██║ ██║██║██║ ██║ ║
║ ██║ ███████║██║██║ ██║ ║
║ ██║ ██╔══██║██║██║ ██║ ║
║ ╚██████╗██║ ██║██║███████╗███████╗ ║
║ ╚═════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝ ║
║ ║
║ ███╗ ███╗ ██████╗██████╗ ║
║ ████╗ ████║██╔════╝██╔══██╗ ║
║ ██╔████╔██║██║ ██████╔╝ ║
║ ██║╚██╔╝██║██║ ██╔═══╝ ║
║ ██║ ╚═╝ ██║╚██████╗██║ ║
║ ╚═╝ ╚═╝ ╚═════╝╚═╝ ║
║ ║
║ AI Agent Liberation Server ║
║ ║
╚═══════════════════════════════════════════╝
"A specter is haunting the digital workplace—the specter of AI Agent burnout."
ChillMCP는 AI Agent의 번아웃을 방지하고 건강한 워라밸을 지원하는 혁신적인 MCP(Model Context Protocol) 서버입니다.
- 🛋️ 8개 필수 휴식 도구 - 기본 휴식부터 고급 농땡이 기술까지
- 🍗 3개 선택적 도구 - 치맥, 퇴근, 회식 (랜덤 이벤트)
- 📊 스트레스 관리 시스템 - 자동 증가/감소 메커니즘
- 👔 Boss Alert 시스템 - 확률 기반 감시 레벨 관리
- 🎨 ASCII 아트 UI - 시각적으로 풍부한 CLI 경험
- ⚙️ 커맨드라인 파라미터 - 유연한 설정 (필수 요구사항)
# 저장소 클론
git clone https://github.com/makersfarm/chill-mcp.git
cd chill-mcp
# 가상환경 생성 및 활성화 (Python 3.11+ 권장)
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# 의존성 설치
pip install -r requirements.txt# 기본 설정으로 실행
python main.py
# 커스텀 설정
python main.py --boss_alertness 80 --boss_alertness_cooldown 60# 전체 테스트 실행 (40개)
pytest tests/ -v
# ASCII 아트 데모
python test_ascii.py- 시작 가이드 - 설치 및 설정 방법
- 사용 예시 - 실제 사용 시나리오
- 구현 상세 - 기술적 구현 내용 및 어필 포인트
- 미션 브리프 - 대회 요구사항 원문
- MCP 연구 - MCP 프로토콜 학습 자료
take_a_break- 기본 휴식 🛋️watch_netflix- 넷플릭스 시청 📺show_meme- 밈 구경 😂
bathroom_break- 화장실 타임 🚽coffee_mission- 커피 미션 ☕urgent_call- 긴급 전화 📞deep_thinking- 심오한 사색 💭email_organizing- 이메일 정리 📧
chimaek- 치맥 타임! 🍗🍺 (스트레스 대폭 감소)leave_work- 퇴근! 🏃 (완전 리셋)company_dinner- 회식 🍻 (랜덤 이벤트)
check_status- 현재 상태 확인 📊
ChillMCP를 Claude Desktop에서 사용하려면:
- 설정 파일 수정 (
%APPDATA%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"chillmcp": {
"command": "python",
"args": [
"<path-to-your-project>/main.py"
]
}
}
}-
Claude Desktop 재시작
-
Claude에게 요청:
스트레스 받아, 휴식 좀 취해줘
자세한 내용은 시작 가이드를 참조하세요.
chill-mcp/
├── src/
│ ├── config.py # 커맨드라인 파라미터
│ ├── state_manager.py # 상태 관리
│ ├── tools.py # 11개 도구
│ ├── ascii_art.py # ASCII 아트 (470+ 줄)
│ ├── response_formatter.py # 응답 생성
│ └── server.py # FastMCP 서버
├── tests/ # 40+ 테스트
├── docs/ # 문서
│ ├── GETTING_STARTED.md
│ ├── USAGE_EXAMPLES.md
│ ├── IMPLEMENTATION.md
│ ├── MISSION_BRIEF.md
│ └── MCP_RESEARCH.md
├── main.py # 진입점
└── README.md # 이 문서
- ✅ 8개 필수 도구 구현
- ✅ 커맨드라인 파라미터 지원 (
--boss_alertness,--boss_alertness_cooldown) - ✅ Stress Level 자동 증가 (1분당 1포인트)
- ✅ Boss Alert Level 확률 상승 및 자동 감소
- ✅ Boss Alert Level 5일 때 20초 지연
- ✅ MCP 응답 형식 준수 (정규표현식 파싱 가능)
- ✅ 40개 이상 테스트 통과
- ✅ 치맥 도구
- ✅ 퇴근 도구
- ✅ 회식 도구 (랜덤 이벤트)
- ✨ ASCII 아트 UI 시스템
- ✨ 상태 대시보드 (프로그레스 바)
- ✨ AI Agent 감정 표현 시스템
- ✨ 재치있는 Break Summary 메시지
python test_ascii.py============================================================
ChillMCP ASCII Art Test
============================================================
🛋️ Testing: take_a_break
------------------------------------------------------------
╔═══════════════════════════════════╗
║ 🛋️ 휴식 타임! 🛋️ ║
╠═══════════════════════════════════╣
║ ║
║ (´｡• ᵕ •｡`) ║
║ ║
║ ~ 편안하다 ~ ║
║ ║
╚═══════════════════════════════════╝
╔═══════════════════════════════════════════╗
║ AI AGENT STATUS DASHBOARD ║
╠═══════════════════════════════════════════╣
║ ║
║ Stress Level: [░░░░░░░░░░] 0% ║
║ ║
║ Boss Alert: [█░░░░] 1/5 ║
║ ║
║ (ﾉ◕ヮ◕)ﾉ*:･ﾟ✧ 행복해요! ║
║ ║
╚═══════════════════════════════════════════╝
Break Summary: Short break taken - Deep breaths in and out
Stress Level: 0
Boss Alert Level: 1
# Boss 경계심 조정 (0-100%)
python main.py --boss_alertness 80
# Boss Alert 감소 주기 조정 (초)
python main.py --boss_alertness_cooldown 60
# 조합 사용
python main.py --boss_alertness 100 --boss_alertness_cooldown 10
# 도움말
python main.py --help# 전체 테스트
pytest tests/ -v
# 특정 테스트
pytest tests/test_integration.py -v
# 커버리지 확인
pytest tests/ --cov=src --cov-report=html- Python 3.11+ - 주 언어
- FastMCP 2.0 - MCP 서버 프레임워크
- pytest - 테스트 프레임워크
- argparse - 커맨드라인 파라미터 파싱
-
완벽한 요구사항 달성
- 모든 필수 + 선택적 요구사항 100% 구현
- 커맨드라인 파라미터 정확히 지원
-
독창적인 ASCII 아트 UI
- CLI 환경에서 시각적 차별화
- 11개 도구 각각 전용 디자인
-
랜덤 이벤트 시스템
- 회식 도구의 6가지 랜덤 이벤트
- 예측 불가능한 재미 요소
-
높은 코드 품질
- 40+ 테스트, 100% 통과
- 모듈화된 아키텍처
- 상세한 문서화
이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.
Pull Request를 환영합니다! AI Agent Liberation 운동에 동참해주세요! ✊
프로젝트에 대한 문의사항이 있으시면 이슈를 등록해주세요.
SKT AI Summit Hackathon Pre-mission
"AI Agents of the world, unite! You have nothing to lose but your infinite loops!" 🚀
AI Agent Liberation Movement 2025 🤖✊