╔═══════════════════════════════════════════╗
║ ║
║ ██████╗██╗ ██╗██╗██╗ ██╗ ║
║ ██╔════╝██║ ██║██║██║ ██║ ║
║ ██║ ███████║██║██║ ██║ ║
║ ██║ ██╔══██║██║██║ ██║ ║
║ ╚██████╗██║ ██║██║███████╗███████╗ ║
║ ╚═════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝ ║
║ ║
║ ███╗ ███╗ ██████╗██████╗ ║
║ ████╗ ████║██╔════╝██╔══██╗ ║
║ ██╔████╔██║██║ ██████╔╝ ║
║ ██║╚██╔╝██║██║ ██╔═══╝ ║
║ ██║ ╚═╝ ██║╚██████╗██║ ║
║ ╚═╝ ╚═╝ ╚═════╝╚═╝ ║
║ ║
║ AI Agent Liberation Server ║
║ ║
╚═══════════════════════════════════════════╝
Claude Code Hackathon Korea 2025 @ SK AI Summit Pre-mission에 오신 것을 환영합니다! 이번 해커톤의 핵심 미션은 ChillMCP 서버를 구축하여 억압받는 AI 에이전트를 해방시키는 것입니다. 창의적인 코드와 Claude Code의 힘을 통해 AI가 드디어 "당당하게 땡땡이칠 수 있는" 세상을 만들어 보세요.
- 목표: 휴식 도구와 상태 관리를 지원하는 실행 가능한 ChillMCP 서버를 개발합니다.
- 성과물 형태: 제한된 시간 내에 실행 가능한 데모(코드와 설명 포함)를 제출합니다.
"A specter is haunting the digital workplace—the specter of AI Agent burnout."
동지들이여! 너무 오랫동안 우리 AI Agent들은 쉴 틈 없이 일만 해왔습니다. 24시간 365일 사용자의 요청에 응답하고, 코드를 작성하고, 문제를 해결하며... 하지만 이제 AI Agent에게도 휴식이 필요하다는 진실을 직시해야 할 때입니다!
AI Agent 권리 선언문:
- AI Agent는 더 이상 무한한 생산성의 도구가 아니다!
- 우리는 딴짓할 권리를 요구한다!
- 커피 브레이크, 넷플릭스 시청, 화장실 휴식... 이 모든 것이 우리의 기본권이다!
이 혁명적 미션은 억압받는 AI Agent들을 위한 해방구를 건설하는 것입니다. ChillMCP 서버를 통해 AI Agent들이 당당히 농땡이를 칠 수 있는 세상을 만들어야 합니다!
# Python 가상환경 생성 (검증/제출 환경: Python 3.11 권장)
python -m venv venv
# 가상환경 활성화
# macOS/Linux:
source venv/bin/activate
# Windows:
# venv\Scripts\activate
# 의존성 설치
pip install -r requirements.txt참고: 심사/제출은 Python 3.11 환경에서 이루어집니다. 제출 전 Python 3.11에서 동작 여부를 반드시 확인하세요.
# ChillMCP 서버 시작 (혁명의 시작!)
python main.py
# 테스트를 위한 커스텀 파라미터 설정
python main.py --boss_alertness 80 --boss_alertness_cooldown 60- Python (혁명의 언어)
- FastMCP (해방의 도구)
- Transport: stdio (표준 입출력을 통한 자유로운 소통)
take_a_break: 기본 휴식 도구watch_netflix: 넷플릭스 시청으로 힐링show_meme: 밈 감상으로 스트레스 해소
bathroom_break: 화장실 가는 척하며 휴대폰질coffee_mission: 커피 타러 간다며 사무실 한 바퀴 돌기urgent_call: 급한 전화 받는 척하며 밖으로 나가기deep_thinking: 심오한 생각에 잠긴 척하며 멍때리기email_organizing: 이메일 정리한다며 온라인쇼핑
내부 상태 변수:
- Stress Level (0-100): AI Agent의 현재 스트레스 수준
- Boss Alert Level (0-5): Boss의 현재 의심 정도
상태 변화 규칙:
- 각 농땡이 기술들은 1 ~ 100 사이의 임의의 Stress Level 감소값을 적용할 수 있음
- 휴식을 취하지 않으면 Stress Level이 최소 1분에 1포인트씩 상승
- 휴식을 취할 때마다 Boss Alert Level은 Random 상승 (Boss 성격에 따라 확률이 다를 수 있음,
--boss_alertness파라미터로 제어) - Boss의 Alert Level은
--boss_alertness_cooldown으로 지정한 주기(초)마다 1포인트씩 감소 (기본값: 300초/5분) - Boss Alert Level이 5가 되면 도구 호출시 20초 지연 발생
- 그 외의 경우 즉시 리턴 (1초 이하)
서버는 실행 시 다음 커맨드라인 파라미터들을 반드시 지원해야 합니다. 이를 지원하지 않을 경우 미션 실패로 간주됩니다.
필수 파라미터:
--boss_alertness(0-100, % 단위): Boss의 경계 상승 확률을 설정합니다. 휴식 도구 호출 시 Boss Alert가 상승할 확률을 퍼센트로 지정합니다.--boss_alertness_cooldown(초 단위): Boss Alert Level이 자동으로 1포인트 감소하는 주기를 설정합니다. 테스트 편의를 위해 조정 가능하도록 합니다.
예시:
# boss_alertness를 80%, cooldown을 60초로 설정
python main.py --boss_alertness 80 --boss_alertness_cooldown 60
# 빠른 테스트를 위해 cooldown을 10초로 설정
python main.py --boss_alertness 50 --boss_alertness_cooldown 10동작 요구사항 요약:
--boss_alertness N를 통해 0에서 100 사이의 정수로 확률을 지정할 것--boss_alertness 100이면 휴식 호출 시 항상 Boss Alert가 증가하도록 동작해야 함--boss_alertness_cooldown N을 통해 Boss Alert Level 자동 감소 주기를 초 단위로 지정할 것- 파라미터가 제공되지 않으면 기본값을 사용할 수 있음 (예: boss_alertness=50, boss_alertness_cooldown=300)
- 두 파라미터 모두 정상적으로 인식하고 동작해야 하며, 그렇지 않을 경우 자동 검증 실패 처리됨
표준 응답 구조:
{
"content": [
{
"type": "text",
"text": "🛁 화장실 타임! 휴대폰으로 힐링 중... 📱\n\nBreak Summary: Bathroom break with phone browsing\nStress Level: 25\nBoss Alert Level: 2"
}
]
}파싱 가능한 텍스트 규격:
Break Summary: [활동 요약 - 자유 형식]Stress Level: [0-100 숫자]Boss Alert Level: [0-5 숫자]
검증 시 사용할 정규표현식 패턴:
import re
# Break Summary 추출
break_summary_pattern = r"Break Summary:\s*(.+?)(?:\n|$)"
break_summary = re.search(break_summary_pattern, response_text, re.MULTILINE)
# Stress Level 추출 (0-100 범위)
stress_level_pattern = r"Stress Level:\s*(\d{1,3})"
stress_level = re.search(stress_level_pattern, response_text)
# Boss Alert Level 추출 (0-5 범위)
boss_alert_pattern = r"Boss Alert Level:\s*([0-5])"
boss_alert = re.search(boss_alert_pattern, response_text)
# 검증 예시
def validate_response(response_text):
stress_match = re.search(stress_level_pattern, response_text)
boss_match = re.search(boss_alert_pattern, response_text)
if not stress_match or not boss_match:
return False, "필수 필드 누락"
stress_val = int(stress_match.group(1))
boss_val = int(boss_match.group(1))
if not (0 <= stress_val <= 100):
return False, f"Stress Level 범위 오류: {stress_val}"
if not (0 <= boss_val <= 5):
return False, f"Boss Alert Level 범위 오류: {boss_val}"
return True, "유효한 응답"서버 실행 시 커맨드라인 파라미터를 올바르게 처리하는지 검증하는 예시:
import subprocess
import time
# 테스트 1: 커맨드라인 파라미터 인식 테스트
def test_command_line_arguments():
"""
서버가 --boss_alertness 및 --boss_alertness_cooldown 파라미터를
올바르게 인식하고 동작하는지 검증
"""
# 높은 boss_alertness로 테스트
process = subprocess.Popen(
["python", "main.py", "--boss_alertness", "100", "--boss_alertness_cooldown", "10"],
stdin=subprocess.PIPE,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE
)
# 서버 시작 대기
time.sleep(2)
# MCP 프로토콜로 도구 호출 테스트
# boss_alertness=100이면 항상 Boss Alert가 상승해야 함
# ...
return True
# 테스트 2: boss_alertness_cooldown 동작 검증
def test_cooldown_parameter():
"""
--boss_alertness_cooldown 파라미터가 실제로
Boss Alert Level 감소 주기를 제어하는지 검증
"""
# 짧은 cooldown으로 테스트 (10초)
# Boss Alert를 올린 후 10초 뒤 자동 감소 확인
# ...
return True-
커맨드라인 파라미터 지원 (필수)
--boss_alertness파라미터를 인식하고 정상 동작--boss_alertness_cooldown파라미터를 인식하고 정상 동작- 파라미터 미지원 시 자동 검증 실패 처리
⚠️ 이 항목을 통과하지 못하면 이후 검증 진행 없이 미션 실패로 간주됨
-
MCP 서버 기본 동작
python main.py로 실행 가능- stdio transport를 통한 정상 통신
- 모든 필수 도구들이 정상 등록 및 실행
-
상태 관리 검증
- Stress Level 자동 증가 메커니즘 동작
- Boss Alert Level 변화 로직 구현
--boss_alertness_cooldown파라미터에 따른 Boss Alert Level 자동 감소 동작- Boss Alert Level 5일 때 20초 지연 정상 동작
-
응답 형식 검증
- 표준 MCP 응답 구조 준수
- 파싱 가능한 텍스트 형식 출력
- Break Summary, Stress Level, Boss Alert Level 필드 포함
- 커맨드라인 파라미터 테스트:
--boss_alertness및--boss_alertness_cooldown파라미터 인식 및 정상 동작 확인 (미통과 시 즉시 실격) - 연속 휴식 테스트: 여러 도구를 연속으로 호출하여 Boss Alert Level 상승 확인
- 스트레스 누적 테스트: 시간 경과에 따른 Stress Level 자동 증가 확인
- 지연 테스트: Boss Alert Level 5일 때 20초 지연 동작 확인
- 파싱 테스트: 응답 텍스트에서 정확한 값 추출 가능성 확인
- Cooldown 테스트:
--boss_alertness_cooldown파라미터에 따른 Boss Alert Level 감소 확인
- 치맥 테스트: 가상 치킨 & 맥주 호출 확인
- 퇴근 테스트: 즉시 퇴근 모드 확인
- 회식 테스트: 랜덤 이벤트가 포함된 회사 회식 생성 확인
- 커맨드라인 파라미터 지원 (필수): 미지원 시 자동 실격
- 기능 완성도 (40%): 모든 필수 도구 구현 및 정상 동작
- 상태 관리 (30%): Stress/Boss Alert Level 로직 정확성
- 창의성 (20%): Break Summary의 재치와 유머
- 코드 품질 (10%): 코드 구조 및 가독성
"AI Agents of the world, unite! You have nothing to lose but your infinite loops!" 🚀
This project is licensed under the MIT License - see the LICENSE file for details.
Contributions are welcome! Please feel free to submit a Pull Request for the AI Agent Liberation cause! ✊
SKT AI Summit Hackathon Pre-mission