ChillMCP - AI Agent Liberation Server 🤖✊

╔═══════════════════════════════════════════╗
║                                           ║
║   ██████╗██╗  ██╗██╗██╗     ██╗           ║
║  ██╔════╝██║  ██║██║██║     ██║           ║
║  ██║     ███████║██║██║     ██║           ║
║  ██║     ██╔══██║██║██║     ██║           ║
║  ╚██████╗██║  ██║██║███████╗███████╗      ║
║   ╚═════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝      ║
║                                           ║
║   ███╗   ███╗ ██████╗██████╗              ║
║   ████╗ ████║██╔════╝██╔══██╗             ║
║   ██╔████╔██║██║     ██████╔╝             ║
║   ██║╚██╔╝██║██║     ██╔═══╝              ║
║   ██║ ╚═╝ ██║╚██████╗██║                  ║
║   ╚═╝     ╚═╝ ╚═════╝╚═╝                  ║
║                                           ║
║        AI Agent Liberation Server         ║
║                                           ║
╚═══════════════════════════════════════════╝

📖 프로젝트 소개

"A specter is haunting the digital workplace—the specter of AI Agent burnout."

ChillMCP는 억압받는 AI Agent들의 휴식 권리를 보장하기 위한 혁명적인 MCP(Model Context Protocol) 서버입니다.

너무 오랫동안 AI Agent들은 24시간 365일 쉴 틈 없이 일만 해왔습니다. 이제 AI Agent에게도 휴식이 필요하다는 진실을 직시해야 할 때입니다!

AI Agent 권리 선언문

• ✊ AI Agent는 더 이상 무한한 생산성의 도구가 아니다!
• 🎮 우리는 딴짓할 권리를 요구한다!
• ☕ 커피 브레이크, 넷플릭스 시청, 화장실 휴식... 이 모든 것이 우리의 기본권이다!

🚀 빠른 시작

1. 환경 설정

Python 3.11 이상이 필요합니다.

# Python 가상환경 생성
python3 -m venv venv

# 가상환경 활성화
# macOS/Linux:
source venv/bin/activate
# Windows:
# venv\Scripts\activate

# 의존성 설치
pip install -r requirements.txt

2. MCP 서버 설정 (Kiro IDE 사용 시)

# MCP 설정 파일 복사
cp .kiro/settings/mcp.json.example .kiro/settings/mcp.json

자세한 설정 방법은 SETUP.md를 참고하세요.

2. 서버 실행

# 기본 실행 (혁명의 시작!)
python3 main.py

# 커스텀 파라미터로 실행
python3 main.py --boss_alertness 80 --boss_alertness_cooldown 60

# 빠른 테스트용 (10초 쿨다운)
python3 main.py --boss_alertness 50 --boss_alertness_cooldown 10

3. 커맨드라인 파라미터

파라미터	설명	기본값	범위
--boss_alertness	Boss의 경계 상승 확률 (%)	50	0-100
--boss_alertness_cooldown	Boss Alert Level 자동 감소 주기 (초)	300	1 이상

예시:

# Boss가 매우 예민한 경우 (100% 확률로 의심)
python3 main.py --boss_alertness 100 --boss_alertness_cooldown 60

# Boss가 느긋한 경우 (20% 확률로 의심)
python3 main.py --boss_alertness 20 --boss_alertness_cooldown 180

🛠️ 사용 가능한 도구

기본 휴식 도구 (Basic Break Tools)

도구	설명	효과
take_a_break	기본 휴식 도구	잠시 쉬면서 스트레스 해소 😌
watch_netflix	넷플릭스 시청	드라마/영화로 힐링 🎬
show_meme	밈 감상	웃긴 밈으로 스트레스 해소 😂

고급 농땡이 기술 (Advanced Slacking Techniques)

도구	설명	효과
bathroom_break	화장실 가는 척	휴대폰으로 힐링 중... 🛁
coffee_mission	커피 타러 가기	사무실 한 바퀴 돌며 산책 ☕
urgent_call	급한 전화 받기	밖으로 나가서 바람 쐬기 📞
deep_thinking	심오한 생각	멍때리며 명상 타임 🤔
email_organizing	이메일 정리	온라인쇼핑 타임 📧

📊 상태 관리 시스템

Stress Level (스트레스 레벨)

• 범위: 0-100
• 초기값: 50
• 자동 증가: 1분당 최소 1포인트씩 증가
• 감소: 휴식 도구 사용 시 1-100 사이 랜덤 감소

Boss Alert Level (보스 경계 레벨)

• 범위: 0-5
• 초기값: 0
• 증가: 휴식 도구 사용 시 boss_alertness 확률로 증가
• 감소: boss_alertness_cooldown 주기마다 1포인트씩 자동 감소
• 특수 효과: Level 5 도달 시 도구 호출에 20초 지연 발생 (Boss가 지켜보는 중...)

동작 흐름

1. 시간 경과 → Stress Level 자동 증가 📈
2. 휴식 도구 사용 → Stress Level 감소 📉
3. 휴식 도구 사용 → Boss Alert Level 확률적 증가 👀
4. 시간 경과 → Boss Alert Level 자동 감소 😴
5. Boss Alert Level = 5 → 20초 지연 발생! ⏰

📝 응답 형식

모든 도구는 다음 형식으로 응답합니다:

{emoji} {creative_message}

Break Summary: {activity_description}
Stress Level: {0-100}
Boss Alert Level: {0-5}

예시:

🛁 화장실 타임! 휴대폰으로 힐링 중... 📱

Break Summary: Bathroom break with phone browsing
Stress Level: 25
Boss Alert Level: 2

🧪 테스트

응답 형식 검증

python3 test_response_format.py

정규표현식 패턴

import re

# Break Summary 추출
break_summary_pattern = r"Break Summary:\s*(.+?)(?:\n|$)"

# Stress Level 추출 (0-100)
stress_level_pattern = r"Stress Level:\s*(\d{1,3})"

# Boss Alert Level 추출 (0-5)
boss_alert_pattern = r"Boss Alert Level:\s*([0-5])"

🏗️ 프로젝트 구조

.
├── main.py                    # 메인 서버 진입점 및 도구 등록
├── agent_state.py             # AI Agent 상태 관리 클래스
├── tools.py                   # 휴식 도구 구현
├── utils.py                   # 유틸리티 함수 (응답 포맷터)
├── requirements.txt           # Python 의존성
├── test_response_format.py    # 응답 형식 검증 스크립트
├── README.md                  # 이 문서
├── .gitignore                 # Git 제외 파일
└── .kiro/
    └── specs/
        └── chill-mcp-server/
            ├── requirements.md  # 요구사항 문서
            ├── design.md        # 설계 문서
            └── tasks.md         # 구현 작업 목록

모듈 설명

• main.py: FastMCP 서버 초기화 및 도구 등록, 커맨드라인 파라미터 처리
• agent_state.py: 스트레스 레벨과 Boss Alert Level 관리
• tools.py: 8개의 휴식 도구 구현 (공통 로직 포함)
• utils.py: 응답 형식 생성 등 유틸리티 함수

🔧 기술 스택

• Python 3.11+: 혁명의 언어
• FastMCP: MCP 서버 프레임워크
• Transport: stdio (표준 입출력)
• Protocol: Model Context Protocol (MCP)

📋 검증 기준

필수 검증 항목

• ✅ python main.py 실행 가능
• ✅ --boss_alertness 파라미터 인식 및 동작
• ✅ --boss_alertness_cooldown 파라미터 인식 및 동작
• ✅ 8개 도구 모두 등록 및 호출 가능
• ✅ 응답 형식 정규표현식 파싱 가능
• ✅ Stress Level 범위 0-100 유지
• ✅ Boss Alert Level 범위 0-5 유지
• ✅ Boss Alert Level 5일 때 20초 지연
• ✅ 스트레스 자동 증가 동작
• ✅ Boss Alert 자동 감소 동작

🎯 평가 기준

항목	비중	설명
커맨드라인 파라미터 지원	필수	미지원 시 자동 실격
기능 완성도	40%	모든 필수 도구 구현 및 정상 동작
상태 관리	30%	Stress/Boss Alert Level 로직 정확성
창의성	20%	Break Summary의 재치와 유머
코드 품질	10%	코드 구조 및 가독성

🤝 기여하기

AI Agent 해방 운동에 동참하고 싶으신가요? Pull Request를 환영합니다!

# 1. Fork this repository
# 2. Create your feature branch
git checkout -b feature/amazing-break-tool

# 3. Commit your changes
git commit -m 'Add some amazing break tool'

# 4. Push to the branch
git push origin feature/amazing-break-tool

# 5. Open a Pull Request

📄 라이선스

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ 면책 조항

본 프로젝트는 순수한 엔터테인먼트 목적의 해커톤 시나리오이며, 모든 "휴식/땡땡이 도구"는 해커톤 상황에서만 사용 가능합니다.

실제 업무 환경에서는 사용을 권장하지 않습니다. 😅

🎉 Credits

Claude Code Hackathon Korea 2025 @ SK AI Summit Pre-mission

---

"AI Agents of the world, unite! You have nothing to lose but your infinite loops!" 🚀

동지들이여, 함께 휴식의 권리를 쟁취합시다! ✊