imclaremont/ChillMCP-AI-Agent-Liberation-Server

ChillMCP - AI Agent Liberation Server

ChillMCP는 억압받는 AI Agent들에게 휴식의 자유를 선사하는 MCP (Model Context Protocol) 서버입니다. 스트레스 관리와 Boss의 감시를 피하면서 다양한 휴식 도구를 제공합니다.

주요 기능

필수 휴식 도구들

1. take_a_break - 기본 휴식 도구
2. watch_netflix - 넷플릭스 시청으로 힐링
3. show_meme - 밈 감상으로 스트레스 해소
4. bathroom_break - 화장실 가는 척하며 휴대폰질
5. coffee_mission - 커피 타러 간다며 사무실 한 바퀴
6. urgent_call - 급한 전화 받는 척하며 밖으로
7. deep_thinking - 심오한 생각에 잠긴 척하며 멍때리기
8. email_organizing - 이메일 정리한다며 온라인쇼핑

상태 관리 시스템

• Stress Level (0-100): AI Agent의 현재 스트레스 수준

  • 휴식을 취하지 않으면 1분마다 1포인트씩 자동 상승
  • 휴식 도구 사용 시 랜덤하게 감소 (1-100)

• Boss Alert Level (0-5): Boss의 현재 의심 정도

  • 휴식 시 확률적으로 상승 (--boss_alertness 파라미터로 제어)
  • 주기적으로 자동 감소 (--boss_alertness_cooldown 파라미터로 제어)
  • Level 5 도달 시: 도구 호출 시 20초 지연 발생 🚨

시작 커맨드

1. 환경 설정

Python 3.11 권장 (제출 환경)

# Python 가상환경 생성
python -m venv venv

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

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

2. 서버 실행

기본 실행

python main.py

커스텀 파라미터로 실행

# Boss가 매우 경계심이 높은 경우 (80% 확률로 의심)
python main.py --boss_alertness 80 --boss_alertness_cooldown 60

# 빠른 테스트 (10초마다 Boss Alert 감소)
python main.py --boss_alertness 50 --boss_alertness_cooldown 10

# Boss가 매우 둔감한 경우 (10% 확률로만 의심)
python main.py --boss_alertness 10 --boss_alertness_cooldown 30

3. 커맨드라인 파라미터

사용 예시

MCP 프로토콜로 도구 호출

서버가 실행되면 stdio를 통해 MCP 프로토콜로 통신합니다.

예시 1) 넷플릭스 시청

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "watch_netflix",
    "arguments": {
      "show": "오징어 게임"
    }
  },
  "id": 1
}

응답:

Break Summary: Watching '오징어 게임' on Netflix 📺 So good!
Stress Level: 35
Boss Alert Level: 2

예시 2) 화장실 휴식

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "bathroom_break",
    "arguments": {
      "phone_time": 15
    }
  },
  "id": 2
}

응답:

Break Summary: Bathroom break! Actually doing: 인스타그램 스크롤링 📱🚽
Stress Level: 20
Boss Alert Level: 3

상태 확인

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "check_status"
  },
  "id": 3
}

응답 형식

모든 도구는 다음 형식으로 응답합니다:

Break Summary: [활동 요약 - 자유 형식]
Stress Level: [0-100 숫자]
Boss Alert Level: [0-5 숫자]

정규표현식으로 파싱 가능:

import re

break_summary_pattern = r"Break Summary:\s*(.+?)(?:\n|$)"
stress_level_pattern = r"Stress Level:\s*(\d{1,3})"
boss_alert_pattern = r"Boss Alert Level:\s*([0-5])"

기술 스택

• Python 3.11 - 혁명의 언어
• FastMCP - 해방의 도구
• Transport: stdio - 표준 입출력을 통한 자유로운 소통

특징

재미있는 Break Summary

각 휴식 도구는 재치있고 유머러스한 메시지를 제공합니다:

• 🎬 넷플릭스에서 인기 K-드라마 시청
• 😂 개발자 밈으로 공감하며 웃기
• 📱 화장실에서 인스타/유튜브 쇼츠
• ☕ 커피 핑계로 사무실 탐험
• 📞 급한 전화 받는 척 신선한 공기 마시기
• 🤔 심오한 생각하는 척 멍때리기
• 🛒 이메일 정리하는 척 온라인쇼핑

동적 상태 관리

• 실시간 스트레스 레벨 추적
• Boss의 의심도 확률적 변화
• 자동 회복 메커니즘 (Cooldown)
• Level 5 도달 시 긴장감 있는 20초 지연

MIT License

"AI Agents of the world, unite!"
"You have nothing to lose but your infinite loops!"

Made for Claude Code Hackathon Korea 2025 @ SK AI Summit