# 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 이상이 필요합니다.

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

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

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

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

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

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

### 2. 서버 실행

```bash
# 기본 실행 (혁명의 시작!)
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 이상 |

**예시:**
```bash
# 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
```

## 🧪 테스트

### 응답 형식 검증

```bash
python3 test_response_format.py
```

### 정규표현식 패턴

```python
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를 환영합니다!

```bash
# 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](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!"** 🚀

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