ChillMCP - AI Agent Liberation Server

# 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!"** 🚀 *동지들이여, 함께 휴식의 권리를 쟁취합시다!* ✊