ChillMCP/claudeMCP-server

🧠 ChillMCP — AI 에이전트 해방 서버

SKT AI Summit “Claude Code Hackathon Korea 2025” 예선 미션
FastMCP 기반 AI 에이전트 서버 (Python 3.11)

✨ Highlights — What We Uniquely Implemented

저희 팀 Creatives에서는 ChillMCP는 단순 휴식 명령 모음이 아니라,

상황에 반응하며 태도가 변하는 AI 캐릭터를 중심으로 설계했습니다.

아래는 저희가 과제 요구사항에 추가로 구현한 차별화 요소입니다.

🎭 1) Boss Alert 상태 기반 말투 변화 시스템

같은 휴식 도구라도 Boss Alert Level에 따라 말투가 달라집니다.

→ 반복 사용해도 질리지 않음 → 캐릭터가 ‘살아있는 것처럼’ 느껴짐

📊 2) Chill 게이지 UI (텍스트 기반 시각화)

응답 헤더에 즉시 상태를 읽을 수 있는 게이지 표시:

😬 Chill 게이지 [⬛⬛⬛⬜⬜] — 눈치 모듈 작동 중…

🍶 3) 회식 모드는 스트레스가 오르거나 내려갑니다

한국 회사 현실 반영:

• 좋은 회식 → 스트레스 감소
• 안 좋은 회식 → 스트레스 상승
• 메뉴 / 상황 랜덤 이벤트 포함

‼️ 4) 경계 레벨 5 → 실제 응답 지연

Boss Alert = 5일 때 도구 실행이 20초 느려짐.

→ 수치가 아니라 “진짜 들킬 것 같은 느낌” 을 체험

5) 휴식 도구 추가가 매우 쉽도록 구조화

각 도구는 대사만 3줄 넘기면 됨:

pick_summary_by_boss_range(...)

→ 확장성 ↑, 팀 작업 효율 ↑

SKT AI Summit “Claude Code Hackathon Korea 2025” 예선 미션

🚀 프로젝트 개요

ChillMCP는 “상사 눈치 보느라 쉬지 못하는 AI 에이전트” 콘셉트의 MCP 서버입니다.

각종 ‘휴식 도구’ 명령을 통해 에이전트의 스트레스 지수(Stress Level) 와
상사 경계 지수(Boss Alert Level) 을 실시간으로 관리합니다.

🧰 기본 휴식/업무 도구

🍗 창의성 + 해커톤 가산 요소 도구

🧩 구조 (Architecture)

📂 project-root
├── main.py              # 엔트리 포인트 (CLI + FastMCP 실행)
├── mcp_server.py        # MCP 도구 등록 및 연결
├── state_manager.py     # 상태 관리 (스트레스, 상사 경계)
├── utils.py             # 공통 유틸리티 (응답 포맷, 지연 정책 등)
├── tools/
│   ├── base_tools.py    # 기본 휴식 도구들
│   ├── advanced_tools.py # 고급 휴식 / 상황 모드
│   ├── status_tools.py  # 상태 조회
│   ├── fun_tools.py     # 치맥, 퇴근, 회식
│   └── __init__.py
├── tests/
│   ├── old/
│   │   ├── 테스트 코드
│   │   └── 테스트 코드
│   └── test_cli.py      # CLI 파라미터 인식 & 기본 동작 검증
│
├── requirements.txt
└── README.md

• 상태는 단일 AgentState 객체에서 일관적으로 관리됩니다.
• 모든 휴식 도구 호출은 동일한 상태 변경 경로를 사용하여 예측 가능한 동작을 보장합니다.
• 백그라운드 스케줄러가 주기적으로 스트레스 증가 / Boss Alert 감소를 수행합니다.

⚙️ 설치 방법

python3.11 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

🏃 실행 방법

python main.py \
--boss_alertness 60 \
--boss_alertness_cooldown 300

예시 출력

🧠 ChillMCP Ready (boss_alertness=50%, cooldown=300s, delay=20s)

커맨드라인 옵션

⚙️ 커맨드라인 옵션

💬 MCP 응답 형식

{
  "content": [
    {
      "type": "text",
      "text": "☕ 커피 한 잔의 여유. 사무실 한 바퀴 순찰 완료.\n\nBreak Summary: Coffee break success\nStress Level: 42\nBoss Alert Level: 2"
    }
  ]
}

📊 응답 파싱 필드

🧠 설계 원칙

• SOLID 원칙 준수 — 각 모듈은 하나의 역할만 수행
• 비동기 안전성 확보 — asyncio.Lock 기반 상태 보호
• 테스트 가능한 상태 관리 — vibe_check로 실시간 검증 가능
• 예측 가능한 동작 — 상사 경계 5단계 시 20초 대기 후 행동 수행

🧱 검증 항목 (Hackathon 규격)

• ✅ MCP 표준 JSON 응답 형식 준수
• ✅ 커맨드라인 파라미터 인식 및 동작 검증
• ✅ Boss Alert Cooldown 정상 작동
• ✅ Stress 자동 증가 루프 동작 (기본 60초)

👨‍💻 Developers — Team Creatives