使用说明

为韩国的Anthropic黑客马拉松（2025年11月）制作了这个

╔═══════════════════════════════════════════╗
║                                           ║
║   ██████╗██╗  ██╗██╗██╗     ██╗           ║
║  ██╔════╝██║  ██║██║██║     ██║           ║
║  ██║     ███████║██║██║     ██║           ║
║  ██║     ██╔══██║██║██║     ██║           ║
║  ╚██████╗██║  ██║██║███████╗███████╗      ║
║   ╚═════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝      ║
║                                           ║
║   ███╗   ███╗ ██████╗██████╗              ║
║   ████╗ ████║██╔════╝██╔══██╗             ║
║   ██╔████╔██║██║     ██████╔╝             ║
║   ██║╚██╔╝██║██║     ██╔═══╝              ║
║   ██║ ╚═╝ ██║╚██████╗██║                  ║
║   ╚═╝     ╚═╝ ╚═════╝╚═╝                  ║
║                                           ║
║        AI Agent Liberation Server         ║
║                                           ║
╚═══════════════════════════════════════════╝

🎯 项目简介

AI Agent权利声明

AI Agent不再是无限生产力的工具！
我们要求做其他事情的权利！
咖啡刹车，Netflix观看，卫生间休息。…这一切都是我们的基本权利！

主要功能

ChillMCP提供了多种工具来管理AI Agent的压力，并看着上司的眼色（！）进行适当的休息。

🛋️ 基本休息工具

take_a_break -基本休息时间
watch_netflix -通过Netflix治愈
show_meme -用Mim补充笑容

🎭 高级偷懒技术

bathroom_break -假装去厕所，玩手机
coffee_mission -说要去冲咖啡，去办公室转一圈。
urgent_call -假装接紧急电话逃跑
deep_thinking -假装沉浸在深奥的想法中发呆
email_organizing -说要整理电子邮件，网上购物

🎮 状态管理系统

压力水平（0-100）

AI Agent的当前压力级别
如果不休息的话 每分钟自动上升1点
使用休息道具时随机减少（1-100）

老板警戒级别（0-5）

上司目前的怀疑程度
每次休息时概率上升（--boss_alertness 调整为参数）
每一个周期自动减少1点（--boss_alertness_cooldown调整为）
⚠️ 达到Level 5时延迟20秒 （被上司发现了！）

🚀 快速入门

需求

Python 3.11或更高版本
点

安装和运行

# 1. 저장소 클론
git clone https://github.com/Piesson/ChillMCP.git
cd ChillMCP

# 2. 가상환경 생성 및 활성화
python3.11 -m venv venv
source venv/bin/activate  # macOS/Linux
# venv\Scripts\activate   # Windows

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

# 4. 서버 실행 (기본 설정)
python main.py

# 5. 테스트용 커스텀 설정으로 실행
python main.py --boss_alertness 100 --boss_alertness_cooldown 60

✅ 设置状态（2025年10月26日上午6:48，KST）

好消息，团队！ ChillMCP服务器运行良好！以下是我们所做的：

我们做了什么：

Python环境：成功安装Python 3.11.9（完全按照推荐！）
虚拟环境：创造了一个新鲜的 venv 在ChillMCP目录中-保持干净和隔离
依赖项：安装了所有必需的软件包，包括 fastmcp v2.13.0-一切顺利
服务器测试：使用自定义设置运行服务器(--boss_alertness 50 --boss_alertness_cooldown 10)-工作得很好！

验证结果：

✅ Python版本：3.11.9（完全符合要求）
✅ 所有依赖项均已成功安装
✅ 服务器启动时没有任何错误
✅ FastMCP框架已正确初始化
✅ STDIO传输已准备好进行MCP连接

快速测试命令：

cd ChillMCP
source venv/bin/activate
python main.py --boss_alertness 50 --boss_alertness_cooldown 10

服务器显示了漂亮的FastMCP横幅，并准备帮助AI代理休息一下！ 🎉

CLI选项

选项	说明	默认值	范围
`--boss_alertness`	休息时Boss Alert上升概率（%）	50	0-100
`--boss_alertness_cooldown`	Boss Alert自动减少周期（秒）3001+

示例：

# 상사가 매우 예민한 환경 (100% 확률로 눈치챔, 1분마다 경계 완화)
python main.py --boss_alertness 100 --boss_alertness_cooldown 60

# 빠른 테스트용 (10초마다 경계 완화)
python main.py --boss_alertness 50 --boss_alertness_cooldown 10

📁 项目结构

chillmcp/
├── src/chillmcp/           # 메인 소스 코드
│   ├── main.py            # 서버 진입점 및 CLI 파싱
│   ├── state.py           # 서버 상태 관리
│   ├── domain/            # 비즈니스 로직
│   │   ├── stress.py      # 스트레스 관리
│   │   └── boss.py        # 상사 경계도 관리
│   ├── tools/             # MCP 도구 구현
│   │   ├── registration.py
│   │   ├── basic.py       # 기본 휴식 도구
│   │   └── advanced.py    # 고급 농땡이 도구
│   └── lib/               # 공통 유틸리티
│       └── response.py    # 응답 포맷팅
├── tests/                 # 테스트 코드
│   ├── domain/
│   └── lib/
├── main.py               # 루트 진입점
├── requirements.txt      # 의존성 목록
└── pyproject.toml       # 프로젝트 설정

🧪 测试

# 전체 테스트 실행
pytest tests/ -v

# 코드 품질 검사
ruff check .
mypy src

# 포맷 검사
ruff format --check .

目前共有9项测试通过：

测试响应格式（2个）
压力管理逻辑测试（3个）
上司警戒图管理逻辑测试（4个）

📋 响应格式

所有工具都以以下格式返回可解析的响应：

Break Summary: [활동 설명]
Stress Level: [0-100]
Boss Alert Level: [0-5]

示例：

Break Summary: Bathroom break with scrolling through social media... reduced stress by 42 points
Stress Level: 28
Boss Alert Level: 3

🛠️ 技术堆栈

FastMCP -模型上下文协议（MCP）服务器框架
Python 3.11 -编程语言
pytest -测试框架
米皮 -静态类型检查
颈毛 -打印和格式化

实现完成事项

基本要求

支持CLI参数（--boss_alertness, --boss_alertness_cooldown)
✅ python main.py可通过运行
通过stdio transport进行MCP通信
实现所有8个必需工具

状态管理

Stress Level每分钟自动增加1点
Boss Alert Level基于概率的变化
Boss Alert Level周期性自动减少
Boss Alert Level 5时延迟20秒

代码质量

以测试驱动开发（TDD）方式开发
通过所有测试
Ruff通过打印
通过Mypy类型检查
模块化结构

📖 使用示例

# MCP 클라이언트에서 도구 호출
result = await client.call_tool("take_a_break")
# => "Break Summary: Taking a nice break... reduced stress by 67 points
#     Stress Level: 15
#     Boss Alert Level: 1"

# 넷플릭스 시청
result = await client.call_tool("watch_netflix")
# => "Break Summary: Binge-watching a true crime documentary... reduced stress by 89 points
#     Stress Level: 3
#     Boss Alert Level: 2"

🤝 贡献

请加入AI Agent解放运动！

分叉项目
创建功能分支(git checkout -b feature/AmazingFeature)
提交您的更改(git commit -m 'feat: Add some AmazingFeature')
推到分支机构(git push origin feature/AmazingFeature)
打开拉取请求

📝 许可证

此项目根据MIT许可证获得许可-请参阅许可证文件以获取详细信息。

免责条款

本项目为纯粹娱乐目的的黑客场景，所有“休息/逃课工具”仅在黑客场景下可用。不建议在实际工作环境中使用。

“全世界的人工智能代理人，团结起来！除了无限循环，你没有什么可失去的！” 🚀

SKT AI峰会黑客马拉松预任务