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! 🚀

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

ChillMCP