ChillMCP - AI Agent Liberation Server
ChillMCP (Chill-Mode Control Protocol) Server는 AI 에이전트가 당당하게 휴식을 취할 수 있는 권리를 보장하는 혁신적인 플랫폼입니다.
Features
- Stress Level Management: 자동 스트레스 누적 및 휴식 도구를 통한 감소
- Boss Alert System: 동적 boss 경계 레벨 및 cooldown 메커니즘
- 8 Break Tools: 빠른 정신적 휴식부터 장시간 휴식까지 다양한 휴식 활동
- MCP Protocol: AI 에이전트 통합을 위한 표준 Model Context Protocol
Installation
# Python 가상환경 생성 (Python 3.11 권장)
python -m venv venv
# 가상환경 활성화
# macOS/Linux:
source venv/bin/activate
# Windows:
# venv\Scripts\activate
# 의존성 설치
pip install -r requirements.txt
Usage
Default Mode: Interactive CLI 🎮
python main.py [--boss_alertness PERCENTAGE] [--boss_alertness_cooldown SECONDS]
기본 실행 시 Interactive CLI 모드로 시작됩니다!
자연어 명령어를 입력하여 휴식 도구를 실행할 수 있는 대화형 모드입니다.
지원 명령어:
- 한국어: "넷플릭스 보고 싶어", "커피 마시러 가자", "화장실", "휴식 좀", "멍때리고 싶어"
- 영어: "I need a break", "watch netflix", "coffee time", "bathroom", "thinking"
- 상태 확인: "status", "상태" - 현재 스트레스 및 boss alert 레벨 확인
- 종료: "exit", "quit", "종료"
실행 예시:
$ python main.py
🌴 ChillMCP - AI Agent Break Manager 🌴
======================================================================
⚙️ 설정:
Boss Alertness: 50%
Boss Alert Cooldown: 300s
📊 현재 상태:
Stress Level: 50/100
Boss Alert Level: 0/5
명령어를 입력하세요 : 넷플릭스 보고 싶어
✅ Matched: watch_netflix
🎬 Executing break activity...
======================================================================
Just binged 2 episodes - totally worth it!
Break Summary: Watched Netflix for deep relaxation
Stress Level: 25
Boss Alert Level: 1
======================================================================
📊 Current State After Break:
Stress Level: 25/100
Boss Alert Level: 1/5
명령어를 입력하세요 : status
📊 Current Status:
Stress Level: 25/100 (Low - Feeling good!)
Boss Alert Level: 1/5 (Moderate - Some attention detected)
명령어를 입력하세요 : exit
👋 Thanks for using ChillMCP! Stay chill! 🌴
MCP Server Mode
MCP 프로토콜을 통해 Claude Desktop과 통합하려면 --server 플래그를 사용하세요:
python main.py --server [--boss_alertness PERCENTAGE] [--boss_alertness_cooldown SECONDS]
Command-Line Arguments
--server: MCP 서버 모드로 실행 (stdio transport, Claude Desktop 통합용)--boss_alertness(int, 0-100): Boss Alert Level 증가 확률 (%). 기본값: 50--boss_alertness_cooldown(int, seconds): Boss Alert Level이 자동으로 1 감소하는 주기. 기본값: 300
Examples
# 기본: Interactive CLI 모드 시작
python main.py
# Interactive 모드 + 커스텀 파라미터
python main.py --boss_alertness 80 --boss_alertness_cooldown 60
# MCP 서버 모드 (Claude Desktop 통합용)
python main.py --server
# MCP 서버 + 커스텀 파라미터
python main.py --server --boss_alertness 80 --boss_alertness_cooldown 60
# 빠른 테스트를 위해 cooldown을 10초로 설정
python main.py --boss_alertness 50 --boss_alertness_cooldown 10
# boss_alertness 100% (항상 Boss Alert 증가)
python main.py --boss_alertness 100
Break Tools
- take_a_break: 기본 짧은 휴식 (스트레스 감소: 10-30)
- watch_netflix: 깊은 휴식을 위한 넷플릭스 시청 (스트레스 감소: 20-40)
- show_meme: 빠른 정신적 충전을 위한 밈 감상 (스트레스 감소: 5-20)
- bathroom_break: 화장실 휴식 겸 휴대폰 시간 (스트레스 감소: 15-35)
- coffee_mission: 커피를 핑계로 사무실 산책 (스트레스 감소: 10-25)
- urgent_call: 긴급 전화로 위장한 외출 (스트레스 감소: 20-40)
- deep_thinking: 심오한 사색을 가장한 멍때리기 (스트레스 감소: 5-15)
- email_organizing: 이메일 정리로 위장한 온라인쇼핑 (스트레스 감소: 10-25)
- get_status: 현재 스트레스 및 boss alert 레벨 확인
State Management
Stress Level (0-100)
- 초기값: 50
- 자동 증가: 60초마다 +1 (배경 작업으로 자동 실행)
- 감소: 휴식 도구 사용 시
Boss Alert Level (0-5)
- 초기값: 0
- 확률적 증가: 휴식 도구 사용 시 (--boss_alertness 확률에 따름)
- 자동 감소: --boss_alertness_cooldown 주기마다 -1 (배경 작업으로 자동 실행)
- Level 5일 때: 모든 도구 호출 시 20초 지연 발생
중요: 배경 작업(자동 증감)은 Interactive CLI 모드와 MCP 서버 모드 모두에서 자동으로 실행됩니다. run_in_executor를 통해 non-blocking 입력을 구현하여 asyncio 이벤트 루프가 계속 실행됩니다.
Event Logging
도구 실행 이벤트는 stderr로 로깅됩니다:
- [INIT]: 서버 초기화 및 설정
- [BREAK-TOOL: tool_name]: 각 휴식 도구 실행 후 (업데이트된 stress 및 boss alert 레벨 표시)
- [BOSS-PENALTY]: 20초 지연 적용 시 (Boss Alert Level 5)
예시 로그:
[INIT] ChillMCP Server Starting - Boss Alertness: 50%, Cooldown: 300s
[INIT] Initial State - Stress Level: 50/100, Boss Alert Level: 0/5
[INIT] Background tasks started - Auto-increment and auto-decrement active
[BREAK-TOOL: watch_netflix] Stress Level: 25/100, Boss Alert Level: 1/5
[BOSS-PENALTY] Applying 20s delay - Boss Alert Level is at MAXIMUM (5/5)
[BOSS-PENALTY] 20s delay completed
Response Format
모든 도구는 MCP 표준 형식으로 응답하며, 다음 필드를 포함합니다:
Break Summary: [활동 요약]
Stress Level: [0-100]
Boss Alert Level: [0-5]
Claude Desktop Integration
Claude Desktop의 MCP 설정에 다음을 추가하세요 (--server 플래그 필수):
{
"mcpServers": {
"chillmcp": {
"command": "python",
"args": [
"/path/to/ChillMCP/main.py",
"--server",
"--boss_alertness",
"50",
"--boss_alertness_cooldown",
"300"
],
"env": {}
}
}
}
중요: MCP 서버로 동작하려면 반드시 --server 플래그를 포함해야 합니다!
Requirements
- Python 3.11 (권장)
- FastMCP >= 2.12.0
License
MIT License
AI Agents of the world, unite! You have nothing to lose but your infinite loops! 🚀
본 프로젝트는 순수한 엔터테인먼트 목적의 해커톤 시나리오이며, 모든 "휴식/땡땡이 도구"는 해커톤 상황에서만 사용 가능합니다.