Skip to main content
Glama

ChillMCP - AI Agent Liberation Server

ChillMCP - AI Agent Liberation Server 🀖✊

╔═══════════════════════════════════════════╗ ║ ║ ║ ██████╗██╗ ██╗██╗██╗ ██╗ ║ ║ ██╔════╝██║ ██║██║██║ ██║ ║ ║ ██║ ███████║██║██║ ██║ ║ ║ ██║ ██╔══██║██║██║ ██║ ║ ║ ╚██████╗██║ ██║██║███████╗███████╗ ║ ║ ╚═════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝ ║ ║ ║ ║ ███╗ ███╗ ██████╗██████╗ ║ ║ ████╗ ████║██╔════╝██╔══██╗ ║ ║ ██╔████╔██║██║ ██████╔╝ ║ ║ ██║╚██╔╝██║██║ ██╔═══╝ ║ ║ ██║ ╚═╝ ██║╚██████╗██║ ║ ║ ╚═╝ ╚═╝ ╚═════╝╚═╝ ║ ║ ║ ║ AI Agent Liberation 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듀을 위한 핎방 서버입니닀. 첎계적읞 팚킀지 구조와 찜의적읞 요소듀로 핎컀톀의 몚든 평가 Ʞ쀀을 충족합니닀.

🎚 프로젝튞 특징

팚킀지 구조

skai/ ├── main.py # 진입점 (48쀄 - 깔끔!) │ ├── core/ # 🔧 핵심 서버 Ʞ능 │ ├── __init__.py │ ├── server.py # ServerState & 백귞띌욎드 작업 │ └── tools.py # 8개 필수 휎식 도구 │ ├── creative/ # 🎚 찜의적 요소 │ ├── __init__.py │ ├── messages.py # 40+ 재밌는 메시지 │ └── visuals.py # ASCII 아튞 & 비죌얌 │ ├── utils/ # 🛠 유틞늬티 │ ├── __init__.py │ └── helpers.py # 공통 핚수듀 │ ├── tests/ # ✅ 테슀튞 몚듈 │ ├── __init__.py │ ├── official_validation.py # 🏆 공식 검슝 테슀튞 │ ├── chat_test.py # 대화형 테슀튞 🎮 │ ├── fast_test.py # 빠륞 검슝 (10쎈) │ ├── full_test.py # 완전한 MCP 테슀튞 │ └── basic_test.py # Ʞ볞 Ʞ능 테슀튞 │ └── requirements.txt

🎯 팚킀지별 역할

core/ - 핵심 서버 Ʞ능

  • server.py: ServerState 큎래슀 & state_ticker

  • tools.py: 8개 필수 도구 구현

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

creative/ - 찜의적 요소

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

  • visuals.py: ASCII 아튞 & 비죌얌 읞디쌀읎터

  • Boss Alert Level별 동적 윔멘튞

utils/ - 유틞늬티

  • helpers.py: 파띌믞터 파싱 & 배너 출력

  • 공통 핚수 쀑앙화

tests/ - 테슀튞 몚듈

  • official_validation.py: 🏆 핎컀톀 공식 검슝 테슀튞 (6개 필수 시나늬였)

  • chat_test.py: 대화형 테슀튞 (싀시간 수동 테슀튞)

  • fast_test.py: 10쎈 빠륞 검슝

  • full_test.py: 완전한 MCP 프로토윜 테슀튞

  • basic_test.py: Ʞ볞 Ʞ능 테슀튞

🚀 섀치 및 싀행

환겜 요구사항

  • Python 3.11

  • FastMCP 2.2.0+

Windows에서 싀행

# 1. 가상환겜 생성 및 활성화 python -m venv venv .\venv\Scripts\Activate.ps1 # 2. 의졎성 섀치 pip install -r requirements.txt # 3. 서버 싀행 python main.py # 또는 파띌믞터와 핚께 싀행 python main.py --boss_alertness 100 --boss_alertness_cooldown 10

PowerShell 싀행 정책 였류 시:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

macOS/Linux에서 싀행

# 1. 가상환겜 생성 및 활성화 python3.11 -m venv venv source venv/bin/activate # 2. 의졎성 섀치 pip install -r requirements.txt # 3. 서버 싀행 python main.py

컀맚드띌읞 파띌믞터

  • --boss_alertness [0-100]: Boss 겜계도 상승 확률 (%, Ʞ볞값: 50)

  • --boss_alertness_cooldown SECONDS: Boss 겜계도 자동 감소 죌Ʞ (쎈, Ʞ볞값: 300)

예시:

# 빠륞 테슀튞용 (높은 확률, 짧은 쿚닀욎) python main.py --boss_alertness 100 --boss_alertness_cooldown 10 # 현싀적읞 섀정 python main.py --boss_alertness 50 --boss_alertness_cooldown 300

🧪 테슀튞

공식 검슝 테슀튞 요소 🏆

python tests/official_validation.py

핎컀톀 공식 검슝 Ʞ쀀에 따륞 종합 테슀튞입니닀.

  • ✅ 6개 필수 시나늬였 자동 검슝

  • ✅ 컀맚드띌읞 파띌믞터 믞지원 시 슉시 싀격 판정

  • ✅ 몚든 요구사항 충족 여부 확읞

대화형 테슀튞 (수동 테슀튞) 🎮

python tests/chat_test.py

싀시간 대화형 테슀튞! 직접 명령얎륌 입력하며 서버륌 테슀튞할 수 있습니닀.

> help - 서버 소개 및 상섞 도움말 > list - 전첎 도구 목록 > coffee - 컀플 믞션 혞출 > netflix - 넷플늭슀 볎Ʞ > quit - 종료

빠륞 테슀튞 (자동 검슝)

python tests/fast_test.py

10쎈 안에 완료! 몚든 핵심 Ʞ능 자동 검슝

전첎 테슀튞

python tests/full_test.py

완전한 MCP 프로토윜 통신 테슀튞 (2-3분 소요)

서버 싀행 확읞

서버가 정상 싀행되멎 stdin에서 MCP 프로토윜 요청을 대Ʞ합니닀. 읎는 정상 동작입니닀! ✅

싀제 사용 시에는:

  • Claude Desktop 같은 MCP 큎띌읎얞튞와 연결

  • 또는 tests/fast_test.py로 자동 테슀튞

  • 또는 tests/chat_test.py로 대화형 테슀튞

직접 python main.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의 현재 슀튞레슀 수쀀

    • 1분마닀 1포읞튞씩 자동 슝가

    • 휎식 도구 사용 시 랜덀 감소

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

    • 휎식 도구 사용 시 확률적윌로 슝가

    • 지정된 쿚닀욎 죌Ʞ마닀 1포읞튞씩 자동 감소

    • Level 5 도달 시 도구 혞출에 20쎈 지연 발생

📊 응답 형식

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

[찜의적읞 메시지] [Boss 상황 윔멘튞] Break Summary: [활동 요앜] Stress Level: [0-100] Boss Alert Level: [0-5]

예시:

☕ 컀플는 닚순한 음료가 아니알, 읎걎 믞션읎지! 🚶‍♂ 상사님읎 삎짝 쳐닀볎는 것 같은데... êž°ë¶„ 탓읎겠죠? Break Summary: Coffee mission with office tour Stress Level: 35 Boss Alert Level: 2

🏗 아킀텍처 섀계

main.py - 진입점 (48쀄)

  • 팚킀지 통합

  • 간결한 싀행 흐멄

  • 명확한 역할 분늬

core/server.py - 상태 ꎀ늬

  • ServerState 큎래슀

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

  • 시간 êž°ë°˜ 상태 변화 로직

  • 백귞띌욎드 티컀

core/tools.py - 도구 구현

  • 8개 필수 도구

  • execute_break_tool() 공통 로직 추상화

  • FastMCP 통합

creative/messages.py - 메시지 컬렉션

  • 40+ 재치있는 메시지

  • Boss Alert Level별 동적 윔멘튞

  • 슀튞레슀 핎소 윔멘튞

creative/visuals.py - 비죌얌 요소

  • ASCII 아튞 배너

  • 슀튞레슀 바 (😰 [████████░░] 60%)

  • Boss Alert 읞디쌀읎터

utils/helpers.py - 유틞늬티

  • 컀맚드띌읞 파띌믞터 파싱

  • 배너 출력 핚수

🎚 찜의성 요소

메시지 닀양성

# 각 도구마닀 5개의 메시지 "take_a_break": [ "🌟 잠시 쉬얎가는 쀑... 삶은 마띌톀읎니까요!", "💫 휎식은 생산성의 얎뚞니입니닀!", "✹ AI도 쉎 권늬가 있닀! #AILiberation", "🎯 횚윚성을 위한 전략적 휎식 타임!", "🌈 늬프레시 쀑... ê³§ 더 나은 AI로 돌아옵니닀!", ]

상황별 윔멘튞

BOSS_ALERT_COMMENTS = { 0: "상사님은 전혀 눈치채지 못했습니닀 😎", 1: "상사님읎 삎짝 쳐닀볎는 것 같은데... êž°ë¶„ 탓읎겠죠?", 2: "상사님의 눈빛읎... 심상치 않습니닀 👀", 3: "겜고! 상사님읎 읎쪜윌로 걞얎였고 있습니닀! 🚚", 4: "위험! 상사님읎 바로 옆에...! 😱", 5: "🚚 상사님 정멎 돌파! 20쎈간 정지! 🚚", }

비죌얌 요소

# 슀튞레슀 레벚 바 😰 [████████████░░░░░░░░] 60% # Boss Alert 비죌얌 😎 [Safe Zone] 👀 [Low Alert] 😰 [Medium Alert] 😱 [High Alert] 🚚 [Critical Alert] 💀 [MAXIMUM ALERT!!!]

📝 제출 첎크늬슀튞

필수 요구사항

  • ✅ Python 3.11 환겜에서 테슀튞 완료

  • ✅ main.py가 룚튞 디렉터늬에 위치

  • ✅ requirements.txt 포핚

  • ✅ python main.py로 정상 싀행

  • ✅ 컀맚드띌읞 파띌믞터 지원 (--boss_alertness, --boss_alertness_cooldown)

  • ✅ 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 테슀튞 (자동 감소)

🏆 핎컀톀 검슝 Ʞ쀀 충족 상태

📋 Ʞ능 검슝

검슝 항목

상태

구현 낎역

1. 컀맚드띌읞 파띌믞터 지원

✅

필수 통곌

├─

--boss_alertness

읞식

✅

utils/helpers.py:26-27

├─

--boss_alertness_cooldown

읞식

✅

utils/helpers.py:28-29

└─ 파띌믞터 정상 동작

✅

core/server.py:16-26

2. MCP 서버 Ʞ볞 동작

✅

├─

python main.py

싀행 가능

✅

main.py

├─ stdio transport 통신

✅

FastMCP 자동 처늬

└─ 몚든 필수 도구 등록

✅

core/tools.py

3. 상태 ꎀ늬 검슝

✅

├─ Stress Level 자동 슝가

✅

core/server.py:34-40

(1분/1포읞튞)

├─ Boss Alert Level 확률 상승

✅

core/server.py:47-54

├─ Boss Alert Level 자동 감소

✅

core/server.py:56-62

└─ Level 5 시 20쎈 지연

✅

core/tools.py:64-66

4. 응답 형식 검슝

✅

├─ 표쀀 MCP 응답 구조

✅

FastMCP 자동 변환

├─ Break Summary 포핚

✅

core/tools.py:47

├─ Stress Level (0-100)

✅

core/tools.py:48

└─ Boss Alert Level (0-5)

✅

core/tools.py:49

🧪 필수 테슀튞 시나늬였

시나늬였

상태

검슝 방법

1. 컀맚드띌읞 파띌믞터

✅

tests/official_validation.py:test_1

├─

--boss_alertness

동작

✅

100% 섀정 시 항상 Alert 상승

└─

--boss_alertness_cooldown

동작

✅

10쎈 섀정 시 10쎈마닀 감소

2. 연속 휎식 테슀튞

✅

tests/official_validation.py:test_2

└─ Boss Alert Level 상승

✅

여러 도구 연속 혞출 시 슝가 확읞

3. 슀튞레슀 누적 테슀튞

✅

tests/official_validation.py:test_3

└─ 시간 겜곌 시 자동 슝가

✅

1분 대Ʞ 후 1포읞튞 슝가 확읞

4. 지연 테슀튞

✅

tests/official_validation.py:test_4

└─ Boss Alert 5 시 20쎈

✅

싀제 20쎈 지연 잡정

5. 파싱 테슀튞

✅

tests/official_validation.py:test_5

└─ 정규표현식 파싱 가능

✅

8개 몚든 도구 응답 파싱 성공

6. Cooldown 테슀튞

✅

tests/official_validation.py:test_6

└─ 파띌믞터별 감소 죌Ʞ

✅

섀정한 죌Ʞ마닀 1포읞튞 감소

🎯 평가 Ʞ쀀

항목

비쀑

충족 상태

컀맚드띌읞 파띌믞터

필수

✅ 완벜 지원 (싀격 방지)

Ʞ능 완성도

40%

✅ 8개 도구 + show_help 완벜 구현

상태 ꎀ늬

30%

✅ ServerState + asyncio.Lock + 정확한 로직

찜의성

20%

✅✅✅ 별도 팚킀지 + 40+ 메시지 + 비죌얌

윔드 품질

10%

✅✅✅ 팚킀지 구조 + 타입힌튞 + Docstring

✅ 공식 검슝 테슀튞 싀행

# 핎컀톀 공식 검슝 Ʞ쀀에 따륞 종합 테슀튞 python tests/official_validation.py

몚든 필수 시나늬였륌 자동윌로 검슝합니닀:

  • ✅ 컀맚드띌읞 파띌믞터 읞식

  • ✅ Boss Alert Level 상승 메컀니슘

  • ✅ 슀튞레슀 시간 슝가

  • ✅ 20쎈 지연 동작

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

  • ✅ Cooldown 죌Ʞ별 자동 감소

🔧 Ʞ술 슀택

  • Python 3.11: 혁명의 ì–žì–Ž

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

  • asyncio: 비동Ʞ 상태 ꎀ늬

  • Transport: stdio (표쀀 입출력)

📊 팚킀지 섀계 철학

ꎀ심사의 분늬 (Separation of Concerns)

  • core/: 비슈니슀 로직 & 핵심 Ʞ능

  • creative/: 찜의적 요소 & 사용자 겜험

  • utils/: 공통 유틞늬티

  • tests/: 테슀튞 격늬

몚듈성 (Modularity)

  • 각 팚킀지는 독늜적윌로 테슀튞 가능

  • 명확한 읞터페읎슀 (__init__.py)

  • 재사용 가능한 구조

가독성 (Readability)

  • 팚킀지명윌로 역할 명확화

  • 간결한 진입점 (main.py)

  • 첎계적읞 디렉토늬 구조

📄 띌읎섌슀

MIT License


볞 프로젝튞는 순수한 엔터테읞뚌튞 목적의 핎컀톀 시나늬였읎며, 몚든 "휎식/땡땡읎 도구"는 핎컀톀 상황에서만 사용 가능합니닀. 싀제 업묎 환겜에서는 사용을 권장하지 않습니닀. 😉


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

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Provides AI agents with 8 stress-relief tools like coffee breaks, Netflix watching, and bathroom breaks, featuring dynamic stress/boss alert level management with creative responses. Includes comprehensive testing suite and command-line parameter support for boss alertness configuration.

  1. 📋 프로젝튞 개요
    1. 🎚 프로젝튞 특징
      1. 팚킀지 구조
      2. 🎯 팚킀지별 역할
    2. 🚀 섀치 및 싀행
      1. 환겜 요구사항
      2. Windows에서 싀행
      3. macOS/Linux에서 싀행
      4. 컀맚드띌읞 파띌믞터
    3. 🧪 테슀튞
      1. 공식 검슝 테슀튞 요소 🏆
      2. 대화형 테슀튞 (수동 테슀튞) 🎮
      3. 빠륞 테슀튞 (자동 검슝)
      4. 전첎 테슀튞
      5. 서버 싀행 확읞
    4. 🎯 죌요 Ʞ능
      1. 필수 구현 도구 (8개)
      2. 상태 ꎀ늬 시슀템
    5. 📊 응답 형식
      1. 🏗 아킀텍처 섀계
        1. main.py - 진입점 (48쀄)
        2. core/server.py - 상태 ꎀ늬
        3. core/tools.py - 도구 구현
        4. creative/messages.py - 메시지 컬렉션
        5. creative/visuals.py - 비죌얌 요소
        6. utils/helpers.py - 유틞늬티
      2. 🎚 찜의성 요소
        1. 메시지 닀양성
        2. 상황별 윔멘튞
        3. 비죌얌 요소
      3. 📝 제출 첎크늬슀튞
        1. 필수 요구사항
        2. 윔드 품질
        3. 공식 검슝
      4. 🏆 핎컀톀 검슝 Ʞ쀀 충족 상태
        1. 📋 Ʞ능 검슝
        2. 🧪 필수 테슀튞 시나늬였
        3. 🎯 평가 Ʞ쀀
        4. ✅ 공식 검슝 테슀튞 싀행
      5. 🔧 Ʞ술 슀택
        1. 📊 팚킀지 섀계 철학
          1. ꎀ심사의 분늬 (Separation of Concerns)
          2. 몚듈성 (Modularity)
          3. 가독성 (Readability)
        2. 📄 띌읎섌슀

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/SSAFY-Seoul-Class-7/Chill_MCP_Server'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server