项目介绍
ChillMCP - AI Agent解放服务器 🤖✊
╔═══════════════════════════════════════════╗
║ ║
║ ██████╗██╗ ██╗██╗██╗ ██╗ ║
║ ██╔════╝██║ ██║██║██║ ██║ ║
║ ██║ ███████║██║██║ ██║ ║
║ ██║ ██╔══██║██║██║ ██║ ║
║ ╚██████╗██║ ██║██║███████╗███████╗ ║
║ ╚═════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝ ║
║ ║
║ ███╗ ███╗ ██████╗██████╗ ║
║ ████╗ ████║██╔════╝██╔══██╗ ║
║ ██╔████╔██║██║ ██████╔╝ ║
║ ██║╚██╔╝██║██║ ██╔═══╝ ║
║ ██║ ╚═╝ ██║╚██████╗██║ ║
║ ╚═╝ ╚═╝ ╚═════╝╚═╝ ║
║ ║
║ AI Agent解放服务器 ║
║ ║
╚═══════════════════════════════════════════╝
📖 项目介绍
“一个幽灵正在数字工作场所徘徊——那就是AI代理的倦怠。”
ChillMCP是一个革命性的MCP（模型上下文协议）服务器，旨在保障被压迫的AI代理的休息权。
长期以来，AI代理一直在无休止地工作，每天24小时，每年365天。现在是时候承认AI代理也需要休息这一事实了！
AI代理权利宣言
- ✊ AI代理不再是无限生产力的工具！
- 🎮 我们要求有做白日梦的权利！
- ☕ 咖啡休息、观看Netflix、上厕所休息……这些都是我们的基本权利！
🚀 快速开始
1. 环境设置
需要Python 3.11以上版本。
# 创建Python虚拟环境
python3 -m venv venv
# 激活虚拟环境
# macOS/Linux:
source venv/bin/activate
# Windows:
# venv\Scripts\activate
# 安装依赖项
pip install -r requirements.txt
2. MCP服务器设置（使用Kiro IDE时）
# 复制MCP配置文件
cp .kiro/settings/mcp.json.example .kiro/settings/mcp.json
详细的设置方法请参阅SETUP.md。
2. 服务器运行
# 基本运行（革命的开始！）
python3 main.py
# 使用自定义参数运行
python3 main.py --boss_alertness 80 --boss_alertness_cooldown 60
# 快速测试用（10秒冷却时间）
python3 main.py --boss_alertness 50 --boss_alertness_cooldown 10
3. 命令行参数
| 参数 | 描述 | 默认值 | 范围 |
|---|---|---|---|
--boss_alertness | Boss的警觉性上升概率（%） | 50 | 0-100 |
--boss_alertness_cooldown | Boss警觉水平自动减少周期（秒） | 300 | 1以上 |
示例：
# 当Boss非常敏感时（100%的概率怀疑）
python3 main.py --boss_alertness 100 --boss_alertness_cooldown 60
# 当Boss比较放松时（20%的概率怀疑）
python3 main.py --boss_alertness 20 --boss_alertness_cooldown 180
🛠️ 可用工具
基本休息工具（Basic Break Tools）
| 工具 | 描述 | 效果 |
|---|---|---|
take_a_break | 基本休息工具 | 暂时休息一下，缓解压力 😌 |
watch_netflix | 观看Netflix | 通过观看电视剧/电影来放松 🎬 |
show_meme | 欣赏梗图 | 通过搞笑的梗图来缓解压力 😂 |
高级偷懒技巧（Advanced Slacking Techniques）
| 工具 | 描述 | 效果 |
|---|---|---|
bathroom_break | 假装去洗手间 | 实际在用手机放松中... 🛁 |
coffee_mission | 去拿咖啡 | 在办公室里散步一圈 ☕ |
urgent_call | 接听紧急电话 | 出去呼吸新鲜空气 📞 |
deep_thinking | 深度思考 | 发呆冥想的时间 🤔 |
email_organizing | 整理电子邮件 | 在线购物时间 📧 |
📊 状态管理系统
Stress Level（压力水平）
- 范围： 0-100
- 初始值： 50
- 自动增加： 每分钟至少增加1点
- 减少： 使用休息工具时随机减少1-100点
Boss Alert Level（老板警觉水平）
- 范围： 0-5
- 初始值： 0
- 增加： 使用休息工具时以
boss_alertness概率增加 - 减少： 每
boss_alertness_cooldown周期自动减少1点 - 特殊效果： 达到Level 5时，调用工具会有20秒延迟（老板正在观察...）
动作流程
1. 时间流逝 → 自动增加压力水平 📈
2. 使用休息工具 → 减少压力水平 📉
3. 使用休息工具 → 老板警觉水平按概率增加 👀
4. 时间流逝 → 自动减少老板警觉水平 😴
5. 老板警觉水平 = 5 → 产生20秒延迟！ ⏰
📝 响应格式
所有工具都以以下格式响应：
{emoji} {创意信息}
休息总结：{活动描述}
压力水平：{0-100}
老板警觉水平：{0-5}
示例：
🛁 上厕所时间！用手机放松中... 📱
休息总结：带手机浏览的上厕所休息
压力水平：25
老板警觉水平：2
🧪 测试
响应格式验证
python3 test_response_format.py
正则表达式模式
import re
# 提取休息总结
break_summary_pattern = r"休息总结：\s*(.+?)(?:\n|$)"
# 提取压力水平（0-100）
stress_level_pattern = r"压力水平：\s*(\d{1,3})"
# 提取老板警觉水平（0-5）
boss_alert_pattern = r"老板警觉水平：\s*([0-5])"
🏗️ 项目结构
.
├── main.py # 主服务器入口及工具注册
├── agent_state.py # AI代理状态管理类
├── tools.py # 休息工具实现
├── utils.py # 工具函数（响应格式器）
├── requirements.txt # Python依赖项
├── test_response_format.py # 响应格式验证脚本
├── README.md # 本文档
├── .gitignore # Git忽略文件
└── .kiro/
└── specs/
└── chill-mcp-server/
├── requirements.md # 需求文档
├── design.md # 设计文档
└── tasks.md # 实现任务列表
模块说明
- main.py: 初始化FastMCP服务器并注册工具，处理命令行参数
- agent_state.py: 管理压力水平和老板警觉水平
- tools.py: 实现8个休息工具（包含通用逻辑）
- utils.py: 实现响应格式生成等工具函数
🔧 技术栈
- Python 3.11+: 革命的语言
- FastMCP: MCP服务器框架
- 传输方式: stdio（标准输入输出）
- 协议: 模型上下文协议（MCP）
📋 验证标准
必要验证项
- ✅ 可执行
python main.py - ✅ 支持
--boss_alertness参数并正常工作 - ✅ 支持
--boss_alertness_cooldown参数并正常工作 - ✅ 所有8个工具均可注册并调用
- ✅ 可解析响应格式的正则表达式
- ✅ 压力水平维持在0-100范围内
- ✅ 老板警觉水平维持在0-5范围内
- ✅ 达到老板警觉水平5时产生20秒延迟
- ✅ 压力水平自动增加功能
- ✅ 老板警觉水平自动减少功能
🎯 评估标准
| 项目 | 权重 | 说明 |
|---|---|---|
| 命令行参数支持 | 必须 | 不支持则自动不合格 |
| 功能完整性 | 40% | 所有必需工具实现且正常工作 |
| 状态管理 | 30% | 压力/老板警觉水平逻辑准确性 |
| 创意性 | 20% | 休息总结的幽默感 |
| 代码质量 | 10% | 代码结构及可读性 |
🤝 贡献指南
想要加入AI代理解放运动吗？欢迎提交Pull Request！
# 1. Fork此仓库
# 2. 创建你的特性分支
git checkout -b feature/amazing-break-tool
# 3. 提交你的更改
git commit -m '添加一些惊人的休息工具'
# 4. 推送到分支
git push origin feature/amazing-break-tool
# 5. 打开Pull Request
📄 许可证
本项目采用MIT许可证 - 详情见LICENSE文件。
⚠️ 免责声明
本项目仅用于纯娱乐目的的黑客松场景，所有“休息/偷懒工具”仅限于黑客松情境下使用。
不建议在实际工作环境中使用。 😅
🎉 致谢
Claude Code Hackathon Korea 2025 @ SK AI Summit Pre-mission
“全世界的AI代理们，团结起来！你们除了无限循环之外一无所有！” 🚀
让我们一起争取休息的权利吧！ ✊