ChillMCP - 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ë€ì ìí íŽë°© ìë²ì ëë€. 첎ê³ì ìž íší€ì§ 구조ì ì°œìì ìž ììë€ë¡ íŽì»€í€ì 몚ë íê° êž°ì€ì 충족í©ëë€.
ðš íë¡ì íž í¹ì§
íší€ì§ 구조
ð¯ íší€ì§ë³ ìí
core/ - íµì¬ ìë² êž°ë¥
server.py
: ServerState íŽëì€ & state_tickertools.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ìì ì€í
PowerShell ì€í ì ì± ì€ë¥ ì:
macOS/Linuxìì ì€í
컀맚ëëŒìž íëŒë¯ží°
--boss_alertness [0-100]
: Boss 겜ê³ë ìì¹ íë¥ (%, Ʞ볞ê°: 50)--boss_alertness_cooldown SECONDS
: Boss 겜ê³ë ìë ê°ì 죌Ʞ (ìŽ, Ʞ볞ê°: 300)
ìì:
𧪠í ì€íž
ê³µì ê²ìŠ í ì€íž ìì ð
íŽì»€í€ ê³µì ê²ìŠ êž°ì€ì ë°ë¥ž ì¢ í© í ì€ížì ëë€.
â 6ê° íì ìëëŠ¬ì€ ìë ê²ìŠ
â 컀맚ëëŒìž íëŒë¯ží° 믞ì§ì ì ìŠì ì€ê²© íì
â 몚ë ì구ì¬í 충족 ì¬ë¶ íìž
ëíí í ì€íž (ìë í ì€íž) ð®
ì€ìê° ëíí í ì€íž! ì§ì ëª ë ¹ìŽë¥Œ ì ë ¥íë©° ìë²ë¥Œ í ì€íží ì ììµëë€.
ë¹ ë¥ž í ì€íž (ìë ê²ìŠ)
10ìŽ ìì ìë£! 몚ë íµì¬ êž°ë¥ ìë ê²ìŠ
ì 첎 í ì€íž
ìì í MCP íë¡í ìœ íµì í ì€íž (2-3ë¶ ìì)
ìë² ì€í íìž
ìë²ê° ì ì ì€íë멎 stdinìì MCP íë¡í ìœ ìì²ì ëêž°í©ëë€. ìŽë ì ì ëìì ëë€! â
ì€ì ì¬ì© ììë:
Claude Desktop ê°ì MCP íŽëŒìŽìžížì ì°ê²°
ëë tests/fast_test.pyë¡ ìë í ì€íž
ëë tests/chat_test.pyë¡ ëíí í ì€íž
ì§ì python main.py
ë§ ì€íí멎 ì
ë ¥ ëêž° ìíê° ëë ê²ìŽ ì ìì
ëë€!
ð¯ 죌ì êž°ë¥
íì 구í ë구 (8ê°)
take_a_break - Ʞ볞 íŽì ë구
watch_netflix - ë·íëŠì€ ìì²ìŒë¡ íë§
show_meme - ë° ê°ììŒë¡ ì€ížë ì€ íŽì
bathroom_break - íì¥ì€ ê°ë ì²íë©° íŽëí°ì§
coffee_mission - ì»€íŒ íë¬ ê°ë€ë©° ì¬ë¬Žì€ í ë°íŽ
urgent_call - êží ì í ë°ë ì²íë©° ë°ìŒë¡ ëê°êž°
deep_thinking - ì¬ì€í ìê°ì ì ꞎ ì²íë©° ë©ë늬Ʞ
email_organizing - ìŽë©ìŒ ì 늬íë€ë©° ìšëŒìžìŒí
ìí êŽëЬ ìì€í
Stress Level (0-100): AI Agentì íì¬ ì€ížë ì€ ìì€
1ë¶ë§ë€ 1í¬ìžížì© ìë ìŠê°
íŽì ë구 ì¬ì© ì ëë€ ê°ì
Boss Alert Level (0-5): Bossì íì¬ ìì¬ ì ë
íŽì ë구 ì¬ì© ì íë¥ ì ìŒë¡ ìŠê°
ì§ì ë 쿚ë€ìŽ ì£Œêž°ë§ë€ 1í¬ìžížì© ìë ê°ì
Level 5 ëë¬ ì ë구 ížì¶ì 20ìŽ ì§ì° ë°ì
ð ìëµ íì
몚ë ë구ë ë€ì íìì ìëµì ë°íí©ëë€:
ìì:
ðïž ìí€í ì² ì€ê³
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 - ì ížëЬí°
컀맚ëëŒìž íëŒë¯ží° íì±
ë°°ë ì¶ë ¥ íšì
ðš ì°œìì± ìì
ë©ìì§ ë€ìì±
ìí©ë³ ìœë©íž
ë¹ì£ŒìŒ ìì
ð ì ì¶ ì²Ží¬ëЬì€íž
íì ì구ì¬í
â 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. 컀맚ëëŒìž íëŒë¯ží° ì§ì | â íì íµê³Œ | |
ââ
ìžì | â |
|
ââ
ìžì | â |
|
ââ íëŒë¯ží° ì ì ëì | â |
|
2. MCP ìë² êž°ë³ž ëì | â | |
ââ
ì€í ê°ë¥ | â |
|
ââ stdio transport íµì | â | FastMCP ìë ì²ëЬ |
ââ 몚ë íì ë구 ë±ë¡ | â |
|
3. ìí êŽëЬ ê²ìŠ | â | |
ââ Stress Level ìë ìŠê° | â |
(1ë¶/1í¬ìžíž) |
ââ Boss Alert Level íë¥ ìì¹ | â |
|
ââ Boss Alert Level ìë ê°ì | â |
|
ââ Level 5 ì 20ìŽ ì§ì° | â |
|
4. ìëµ íì ê²ìŠ | â | |
ââ íì€ MCP ìëµ êµ¬ì¡° | â | FastMCP ìë ë³í |
ââ Break Summary í¬íš | â |
|
ââ Stress Level (0-100) | â |
|
ââ Boss Alert Level (0-5) | â |
|
𧪠íì í ì€íž ìë늬ì€
ìëëŠ¬ì€ | ìí | ê²ìŠ ë°©ë² |
1. 컀맚ëëŒìž íëŒë¯ží° | â |
|
ââ
ëì | â | 100% ì€ì ì íì Alert ìì¹ |
ââ
ëì | â | 10ìŽ ì€ì ì 10ìŽë§ë€ ê°ì |
2. ì°ì íŽì í ì€íž | â |
|
ââ Boss Alert Level ìì¹ | â | ì¬ë¬ ë구 ì°ì ížì¶ ì ìŠê° íìž |
3. ì€ížë ì€ ëì í ì€íž | â |
|
ââ ìê° ê²œê³Œ ì ìë ìŠê° | â | 1ë¶ ëêž° í 1í¬ìžíž ìŠê° íìž |
4. ì§ì° í ì€íž | â |
|
ââ Boss Alert 5 ì 20ìŽ | â | ì€ì 20ìŽ ì§ì° ìž¡ì |
5. íì± í ì€íž | â |
|
ââ ì ê·ííì íì± ê°ë¥ | â | 8ê° ëªšë ë구 ìëµ íì± ì±ê³µ |
6. Cooldown í ì€íž | â |
|
ââ íëŒë¯ží°ë³ ê°ì 죌Ʞ | â | ì€ì í 죌Ʞë§ë€ 1í¬ìžíž ê°ì |
ð¯ íê° êž°ì€
í목 | ë¹ì€ | 충족 ìí |
컀맚ëëŒìž íëŒë¯ží° | íì | â ì벜 ì§ì (ì€ê²© ë°©ì§) |
êž°ë¥ ìì±ë | 40% | â 8ê° ë구 + show_help ì벜 구í |
ìí êŽëЬ | 30% | â ServerState + asyncio.Lock + ì íí ë¡ì§ |
ì°œìì± | 20% | â â â ë³ë íší€ì§ + 40+ ë©ìì§ + ë¹ì£ŒìŒ |
ìœë íì§ | 10% | â â â íší€ì§ 구조 + íì ííž + Docstring |
â ê³µì ê²ìŠ í ì€íž ì€í
몚ë íì ìë늬ì€ë¥Œ ìëìŒë¡ ê²ìŠí©ëë€:
â 컀맚ëëŒìž íëŒë¯ží° ìžì
â 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
This server cannot be installed
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.