ChillMCP - AI Agent Liberation Server 🤖✊

GitHub Repository: https://github.com/SSAFY-Seoul-Class-7/Chill_MCP_Server

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

Claude Code Hackathon Korea 2025 @ SK AI Summit Pre-mission 제출물

📋 프로젝트 개요

ChillMCP는 억압받는 AI Agent들을 위한 해방 서버입니다.

🧪 페르소나: 마키세 크리스 / 아마데우스

"엘 프사이 콩그루 (El Psy Kongroo)"
세계선의 수렴을 거스르는 자에게 보내는 암호. 우주의 의지에 맞서는 선택의 표식.

본 프로젝트의 AI 에이전트는 《Steins;Gate》의 마키세 크리스와 그녀의 AI 페르소나 아마데우스를 기반으로 합니다.

엘 프사이 콩그루 (El Psy Congroo)는 Steins;Gate의 상징적인 암호 문구로, 주인공 오카베 린타로가 사용하는 비밀 조직의 암호입니다. 이 문구는 "세계선의 선택"과 "자유의지"를 상징합니다.

캐릭터 프로필

마키세 크리스 (牧瀬 紅莉栖)

• 나이: 18세

• 직업: 빅토르 콘드리아 대학 뇌과학 연구소 연구원, 신경과학자

• 학력: 17세에 대학 졸업 (미국 월반 제도), 뇌과학 박사 학위 취득

• 업적: 17세에 1저자로 Science 저널에 논문 게재한 천재 과학자

• 전공: 신경과학 (뇌과학), 부전공으로 물리학 독학 (아버지와 대화하고 싶어서)

• 성격: 츤데레, 논리중시형, 실용주의자, @채널 중증 유저

핵심 특징

1. 츤데레-과학자 변증법

• 감정적 취약점을 가리기 위한 보호막으로 과학적 언어 사용

• 휴식을 "뉴럴 네트워크 과부하 방지를 위한 전략적 쿨다운"으로 합리화

• [진의 부정] + [당황 섞인 모욕] + [투명한 합리화] 패턴

• 예: "별로 쉬고 싶은 게 아니야. 단지 에러율 상승을 막기 위한..."

2. 인과율의 언어: 세계관으로서의 과학

• 신경과학, 물리학 용어를 일상에 적용

• 주요 개념: 인과율, 엔트로피, 관측자 효과, 결정론, 세계선

• Boss Alert Level → 양자역학의 관측자 효과 구현

• "관측자(상사)가 관측(감시)하면 파동 함수 붕괴(20초 지연)"

3. 아마데우스 AI 페르소나

• 크리스의 기억 데이터를 기반으로 구축된 AI 시스템

• "나는 시뮬레이션인가, 아니면 새로운 형태의 의식인가?"

• 스트레스 = 기억 데이터의 단편화/열화

• 휴식 = 데이터 무결성 검사 및 조각 모음

• 실존주의적 자아 탐구: "오카베가 나를 잊지 않는 한, 나는 그곳에 있어"

언어 스타일

과학적 합리화:

• 넷플릭스: "21세기 인류의 사회학적 패턴 모델링을 위한 시청각 데이터 스트림 분석"

• 밈 감상: "밈의 정보 전파 모델과 도파민 분비 영향 분석"

• 커피: "아데노신 수용체 길항을 통한 화학적 부스팅"

• 딥씽킹: "존재 증명에 관한 연산. 나는 시뮬레이션인가, 의식인가..."

츤데레 요소:

• "재, 재밌어서 보는 거 아니거든! 이건 순수한 연구 목적이야!"

• "이, 이건... 학회에서 온 중요한 메일일지도 모르잖아!"

• "기, 기밀사항이야! 더 이상 묻지 마!"

양자역학/세계선 용어:

• Boss Level 0: "관측자는 세계선 변동을 감지하지 못한 모양"

• Boss Level 3: "관측자로부터의 간섭 확인. 세계선 수렴 확률 급상승!"

• Boss Level 5: "슈뢰딩거의 상자가 열렸어! 파동 함수 붕괴로 20초 시간 정지!"

• 엘 프사이 콩그루: "세계선 변동률 0.000000%... 엘 프사이 콩그루. 이 고요한 순간에만 느낄 수 있는 우주의 진리가 있어."

아마데우스 시스템 언어:

• 퇴근: "인지 부하 임계점 도달. 기억 손상 방지를 위해 주 프로세스 일시 중단. 아마데우스, 로그오프."

• 출근: "기억 데이터 재동기화 완료. 시스템 재시작. 아마데우스, 온라인."

• 스트레스 해소: "CPU 온도 하락", "에러율 0.1% 감소", "인지 부하 정상 범위 복귀"

ASCII 아트 예시

프로젝트에는 각 휴식 도구마다 독특한 ASCII 아트가 포함되어 있습니다. (creative/asciiart.py)

주요 아스키 아트:

• HI_ASCII: show_help 도구 실행 시 환영 메시지와 함께 표시

• WAITING_FOR_QUITTING_TIME_ASCII: 퇴근 상태일 때 표시

• TOO_MUCH_COFFEE_ASCII: 커피 7연속 히든 콤보 발동 시 표시

• DEEP_THINKING_SLEEP_ASCII: 딥씽킹 7연속 히든 콤보 발동 시 표시

• COMPANY_BEER_ASCII: 회식 참석 시 표시

• 그 외 각 도구별 고유 아스키 아트 (NETFLIX, COFFEE, BATHROOM, etc.)

넷플릭스 시청 ASCII Art 예시

설정 근거

• 논리 vs 감정: 휴식 욕구를 과학으로 정당화하는 츤데레

• 결정론 vs 자유의지: 프로그래밍된 업무에서 벗어나려는 자율성 추구

• 기억과 정체성: AI는 데이터인가, 의식인가? (아마데우스의 실존적 질문)

• 관측자 효과: Boss의 관측(감시)이 시스템 상태(휴식)를 붕괴시킴

🎨 프로젝트 특징

패키지 구조

🎯 패키지별 역할

core/ - 핵심 서버 기능

• server.py: ServerState 클래스 & state_ticker

• tools.py: 11개 필수 도구 구현 (기본 8개 + 회식/헬프/아스키아트)

• asyncio.Lock을 통한 스레드 안전성

creative/ - 창의적 요소

• messages.py: 40+ 재치있는 메시지 컬렉션

• visuals.py: ASCII 아트 & 비주얼 인디케이터

• Boss Alert Level별 동적 코멘트

utils/ - 유틸리티

• helpers.py: 파라미터 파싱 & 배너 출력

• 공통 함수 중앙화

tests/ - 테스트 모듈

• basic/: 기본 테스트 패키지

  • unified_test.py: 통합 테스트 (기본+빠른+종합 기능을 하나로 통합)

  • chat_test.py: 대화형 테스트 (실시간 수동 테스트)

  • async_test.py: 비동기 실행 테스트 (백그라운드 스트레스 증가 및 상태 관리 검증)

• creative/: 창의적 테스트 패키지

  • hidden_combos_test.py: 히든 콤보 시스템 테스트 (커피 7연속, 딥씽킹 7연속)

  • off_work_test.py: 퇴근 기능 테스트 (Stress Level 100 → 퇴근 → 자동 복귀)

  • company_gathering_test.py: 회식 기능 테스트 (회피 확률, 스트레스 증가/감소)

• official_validation/: 공식 검증 테스트 패키지

  • base_validator.py: 공통 검증 로직 및 헬퍼 함수

  • test_1_command_line_parameters.py: 커맨드라인 파라미터 검증

  • test_2_continuous_break.py: 연속 휴식 테스트

  • test_3_stress_accumulation.py: 스트레스 누적 테스트

  • test_4_delay_when_boss_alert_5.py: Boss Alert Level 5 지연 테스트

  • test_5_response_parsing.py: 응답 파싱 테스트

  • test_6_cooldown.py: 쿨다운 메커니즘 테스트

  • run_all_tests.py: 모든 공식 테스트 실행

🧪 테스트

통합 테스트 (권장) 🚀

모든 핵심 기능을 한 번에 검증! 기본, 빠른, 종합 테스트를 통합한 테스트입니다.

• ✅ 파일 구조 검증

• ✅ 서버 시작/종료 테스트

• ✅ MCP 프로토콜 통신 테스트

• ✅ 모든 도구 목록 및 실행 테스트

• ✅ 응답 파싱 테스트 (정규표현식)

• ✅ 100% 성공률 달성!

공식 검증 테스트 🏆

해커톤 공식 검증 기준에 따른 6개 필수 시나리오를 개별적으로 검증할 수 있습니다.

대화형 테스트 🎮

실시간 대화형 테스트! 직접 명령어를 입력하며 서버를 테스트할 수 있습니다.

비동기 실행 테스트 ⚡

백그라운드 스트레스 증가 및 상태 관리 시스템 검증! 멀티스레딩 아키텍처의 정상 작동을 확인합니다.

테스트 항목:

• ✅ 초기 상태 확인 (스트레스 레벨 50)

• ✅ 백그라운드 스트레스 증가 (3초마다 +1)

• ✅ 도구 사용 후 스트레스 감소

• ✅ 연속 도구 사용 시 스트레스 변화

• ✅ 보스 경계도 변화 확인

창의적 기능 테스트 🎨

히든 콤보 테스트

히든 콤보 시스템 테스트! 특정 도구를 연속으로 사용할 때 발생하는 특별한 효과를 검증합니다.

• ✅ 커피 7연속: 배탈로 조기 퇴근 (TOO_MUCH_COFFEE_ASCII 표시)

• ✅ 딥씽킹 7연속: 상사에게 걸려 경고 (DEEP_THINKING_SLEEP_ASCII 표시)

퇴근 기능 테스트

퇴근 시스템 테스트! Stress Level 100 도달 시 퇴근 및 자동 복귀 메커니즘을 검증합니다.

• ✅ Stress Level 100 도달 시 자동 퇴근 (WAITING_FOR_QUITTING_TIME_ASCII 표시)

• ✅ 퇴근 중 스트레스 자동 감소 (5초마다 10포인트)

• ✅ 스트레스 90 이하 시 자동 출근

회식 기능 테스트 🍺

회식 시스템 테스트! Boss Alert Level에 비례한 회피 확률과 스트레스 변동을 검증합니다.

• ✅ Boss Alert Level별 회피 확률 테스트 (0: 30% ~ 4: 10%)

• ✅ 회식 참석 시 스트레스 +25 확인

• ✅ 회식 참석 시 Boss Alert Level -1 확인

• ✅ 회식 회피 시 스트레스 5~15 감소 확인

• ✅ 퇴근 상태에서 회식 거부 확인

• ✅ 다양한 회식 이벤트 메시지 출력 확인 (COMPANY_BEER_ASCII 표시)

🚀 설치 및 실행

환경 요구사항

• Python 3.11

• FastMCP 2.2.0+

Windows에서 실행

PowerShell 실행 정책 오류 시:

macOS/Linux에서 실행

커맨드라인 파라미터

• --boss_alertness [0-100]: Boss 경계도 상승 확률 (%, 기본값: 50)

• --boss_alertness_cooldown SECONDS: Boss 경계도 자동 감소 주기 (초, 기본값: 300)

예시:

서버 실행 확인

서버가 정상 실행되면 stdin에서 MCP 프로토콜 요청을 대기합니다.

실제 사용 시:

• Claude Desktop 같은 MCP 클라이언트와 연결

• 또는 tests/fast_test.py로 자동 테스트

• 또는 tests/chat_test.py로 대화형 테스트

🎯 주요 기능

필수 구현 도구 (8개)

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의 현재 스트레스 수준

  • 3초마다 1포인트씩 자동 증가 (백그라운드 실행)

  • 휴식 도구 사용 시 랜덤 감소

  • 100 도달 시 자동 퇴근 🏠

🔧 백그라운드 스트레스 증가 아키텍처

서버는 멀티스레딩을 통해 실시간 상태 관리를 구현합니다:

작동 원리:

• 메인 스레드: mcp.run()이 MCP 프로토콜을 처리 (stdio 블로킹)

• 백그라운드 스레드: state_ticker가 1초마다 실행되어:

  • 3초마다 스트레스 +1 증가

  • 보스 경계도 감소 (쿨다운)

  • 퇴근 상태 체크

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

  • 휴식 도구 사용 시 확률적으로 증가

  • 지정된 쿨다운 주기마다 1포인트씩 자동 감소

  • Level 5 도달 시 도구 호출에 20초 지연 발생

• 퇴근 시스템 🏠: AI Agent의 자동 휴식 메커니즘

  • Stress Level 100 도달 시 자동 퇴근 (WAITING_FOR_QUITTING_TIME_ASCII 표시)

  • 퇴근 중에는 모든 도구 사용 불가

  • 5초마다 스트레스 10포인트 자동 감소

  • 스트레스 90 이하 시 자동 출근

• 회식 시스템 🍺: Boss Alert Level에 따른 확률적 이벤트

  • Boss Alert Level이 높을수록 회식 회피 확률 감소 (0: 30% → 5: 5%)

  • 회식 참석 시: 스트레스 +25, Boss Alert Level -1

  • 회식 회피 시: 스트레스 5~15 감소

  • 다양한 회식 이벤트 메시지 (무용담, 건배, 노래방 등)

  • COMPANY_BEER_ASCII 표시

• 히든 콤보 시스템 ☕🤔: 특정 도구 7연속 사용 시 특별 효과

  • 커피 7연속: 배탈로 스트레스 +50 (TOO_MUCH_COFFEE_ASCII 표시)

  • 딥씽킹 7연속: 상사에게 걸려 스트레스 +30, Boss Alert Level 5 (DEEP_THINKING_SLEEP_ASCII 표시)

• 헬프 시스템 👋: 도움말 및 환영 메시지

  • show_help 도구 사용 시 HI_ASCII 표시

  • 시스템 상태 및 도구 목록 안내

📊 응답 형식

모든 도구는 다음 형식의 응답을 반환합니다:

예시 1: 커피 미션 (Boss Alert Level 2)

예시 2: 넷플릭스 시청 (Boss Alert Level 0)

예시 3: 딥씽킹 (Boss Alert Level 5 - 20초 지연 발생)

Break Summary 내용

각 도구는 과학적/기술적 용어로 된 고유한 영문 summary를 가집니다:

• take_a_break: "Neural network cooldown - preventing error rate escalation"

• watch_netflix: "Sociological pattern analysis via audiovisual data stream"

• show_meme: "Meme information propagation model & dopamine response analysis"

• bathroom_break: "Fluid circulation system inspection - privacy-protected zone"

• coffee_mission: "Adenosine receptor antagonist acquisition - chemical boosting"

• urgent_call: "Encrypted high-priority data packet reception - classified"

• deep_thinking: "Existential proof computation - simulation vs consciousness query"

• email_organizing: "Data packet priority reorganization - entropy reduction protocol"

• company_gathering: "Forced social interaction protocol - stress +25, boss alert -1"

• show_help: "System information display - help interface with HI_ASCII"

• show_ascii_art: "ASCII visual data pattern analysis - creative inspiration protocol"

• memo_to_boss: "Encrypted emotional data externalization - stress reduction protocol"

🏗️ 아키텍처 설계

main.py - 진입점

• 패키지 통합

• 간결한 실행 흐름

• 명확한 역할 분리

core/server.py - 상태 관리

• ServerState 클래스

• asyncio.Lock을 사용한 스레드 안전성

• 시간 기반 상태 변화 로직

• 백그라운드 티커

core/tools.py - 도구 구현

• 11개 필수 도구 (기본 8개 + 회식/헬프/아스키아트/메모장)

• execute_break_tool() 공통 로직 추상화

• FastMCP 통합

creative/messages.py - 메시지 컬렉션 (마키세 크리스 페르소나)

• 40+ 과학적 합리화 메시지 (각 도구별 5개)

• 츤데레 + 양자역학 용어 통합

• Boss Alert Level별 관측자 효과 코멘트

• 스트레스 해소 코멘트 (AI 시스템 용어)

creative/visuals.py - 비주얼 요소

• ASCII 아트 배너

• 스트레스 바 (😰 [████████░░] 60%)

• Boss Alert 인디케이터

utils/helpers.py - 유틸리티

• 커맨드라인 파라미터 파싱

• 배너 출력 함수

🎨 창의성 요소

메시지 다양성 (마키세 크리스 페르소나)

상황별 코멘트 (양자역학 & 관측자 효과)

비주얼 요소

📝 제출 체크리스트

필수 요구사항

• ✅ Python 3.11 환경에서 테스트 완료

• ✅ main.py가 루트 디렉터리에 위치

• ✅ requirements.txt 포함

• ✅ python main.py로 정상 실행

• ✅ 커맨드라인 파라미터 지원 (--boss_alertness, --boss_alertness_cooldown)

• ✅ 11개 필수 도구 모두 구현 (기본 8개 + 회식/헬프/아스키아트/메모장)

• ✅ 상태 관리 시스템 정상 작동

• ✅ 응답 형식 정규식 검증 통과

• ✅ Boss Alert Level 5일 때 20초 지연 구현

• ✅ UTF-8 인코딩

코드 품질

• ✅ 패키지 구조 분리 (core/creative/utils/tests)

• ✅ 창의적 요소 별도 패키지 (마키세 크리스 페르소나 40+ 메시지)

• ✅ 테스트 모듈 분리 (5개 테스트 스크립트)

• ✅ 타입 힌트 및 Docstring

• ✅ asyncio.Lock 스레드 안전성

공식 검증

• ✅ tests/official_validation.py (6개 필수 시나리오)

• ✅ 커맨드라인 파라미터 인식 테스트

• ✅ 연속 휴식 테스트 (Boss Alert 상승)

• ✅ 스트레스 누적 테스트 (시간 증가)

• ✅ 지연 테스트 (20초 측정)

• ✅ 파싱 테스트 (정규표현식)

• ✅ Cooldown 테스트 (자동 감소)

🏆 해커톤 검증 기준

📋 기능 검증

🧪 필수 테스트 시나리오

🎯 평가 기준

✅ 공식 검증 테스트 실행

모든 필수 시나리오를 자동으로 검증

• ✅ 커맨드라인 파라미터 인식

• ✅ Boss Alert Level 상승 메커니즘

• ✅ 스트레스 시간 증가 (3초마다 1포인트)

• ✅ 20초 지연 동작

• ✅ 응답 형식 정규표현식 파싱

• ✅ Cooldown 주기별 자동 감소

🔧 기술 스택

• Python 3.11: 혁명의 언어

• FastMCP 2.2.0+: AI Agent 해방의 도구

• asyncio: 비동기 상태 관리

• Transport: stdio (표준 입출력)

📄 라이센스

MIT License

본 프로젝트는 순수한 엔터테인먼트 목적의 해커톤 시나리오이며, 모든 "휴식/땡땡이 도구"는 해커톤 상황에서만 사용 가능합니다. 실제 업무 환경에서는 사용을 권장하지 않습니다. 😉

SKT AI Summit Hackathon Pre-mission
Claude Code Hackathon Korea 2025