AI导哈

AI代理压力管理服务器

ChillMCP是一款为AI代理提供压力管理和休息支持的MCP服务器，旨在防止AI代理的过度疲劳并促进健康的工作与休息平衡。

  • by makersfarm
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Chill-Makersfarm/chill-mcp

使用说明

ChillMCP-人工智能代理解放服务器🤖✊

SKT AI峰会黑客马拉松预任务 -支持AI Agent压力管理和休息的MCP服务器

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

🌟 项目简介

“一个幽灵正在困扰着数字工作场所——人工智能代理倦怠的幽灵。”

ChillMCP是一款创新的Model Context Protocol（MCP）服务器，可防止AI Agent的蔓延，并支持健康的工作负载。

核心功能

  • 🛋️ 8个必要的休息工具 -从基本休息到高级偷懒技术
  • 🍗 3个可选工具 -炸鸡啤酒，下班，聚餐（随机活动）
  • 📊 压力管理系统 -自动增加/减少机制
  • 👔 Boss Alert系统 -基于概率的监视级别管理
  • 🎨 ASCII艺术UI -丰富的CLI视觉体验
  • ⚙️ 命令行参数 -灵活的设置（必需的要求）

🚀 快速入门

安装

# 저장소 클론
git clone https://github.com/makersfarm/chill-mcp.git
cd chill-mcp

# 가상환경 생성 및 활성화 (Python 3.11+ 권장)
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

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

执行

# 기본 설정으로 실행
python main.py

# 커스텀 설정
python main.py --boss_alertness 80 --boss_alertness_cooldown 60

测试

# 전체 테스트 실행 (40개)
pytest tests/ -v

# ASCII 아트 데모
python test_ascii.py

📖 文档

🎮 可用工具

基本休息工具

  • take_a_break -基本休息🛋️
  • watch_netflix -观看Netflix📺
  • show_meme -参观米姆😂

高级偷懒技术

  • bathroom_break -厕所时间🚽
  • coffee_mission -咖啡任务
  • urgent_call -紧急电话📞
  • deep_thinking -深奥的思索💭
  • email_organizing -整理电子邮件📧

可选工具（特殊功能）

  • chimaek -炸鸡啤酒时间！ 🍗🍺 （大幅减少压力）
  • leave_work -下班！ 🏃 （完全重置）
  • company_dinner -聚餐🍻 （随机事件）

实用程序

  • check_status -检查当前状态📊

💻 Claude Desktop集成

在Claude Desktop中使用ChillMCP：

  1. 修改配置文件 (%APPDATA%\Claude\claude_desktop_config.json):
{
  "mcpServers": {
    "chillmcp": {
      "command": "python",
      "args": [
        "<path-to-your-project>/main.py"
      ]
    }
  }
}

  1. 重新启动Claude Desktop

  2. 请求Claude:

스트레스 받아, 휴식 좀 취해줘

有关详细信息，请访问 开始指南请参阅。

🏗️ 项目结构

chill-mcp/
├── src/
│   ├── config.py              # 커맨드라인 파라미터
│   ├── state_manager.py       # 상태 관리
│   ├── tools.py               # 11개 도구
│   ├── ascii_art.py           # ASCII 아트 (470+ 줄)
│   ├── response_formatter.py  # 응답 생성
│   └── server.py              # FastMCP 서버
├── tests/                     # 40+ 테스트
├── docs/                      # 문서
│   ├── GETTING_STARTED.md
│   ├── USAGE_EXAMPLES.md
│   ├── IMPLEMENTATION.md
│   ├── MISSION_BRIEF.md
│   └── MCP_RESEARCH.md
├── main.py                    # 진입점
└── README.md                  # 이 문서

实现完成核对表

必需要求（100%）

  • 实现8个必备工具
  • 支持命令行参数（--boss_alertness, --boss_alertness_cooldown)
  • Stress Level自动增加（每分钟1点）
  • Boss Alert Level概率上升和自动下降
  • Boss Alert Level 5时延迟20秒
  • 遵守MCP响应格式（可解析正则表达式）
  • 通过40个以上的测试

可选要求（100%）

  • 炸鸡啤酒工具
  • 下班工具
  • 分享聚餐工具（随机活动）

附加功能（创意分数UP！）

  • ASCII艺术UI系统
  • 状态仪表板（升级条）
  • AI Agent情感表达系统
  • 机智的Break Summary信息

🎨 演示示例

python test_ascii.py

============================================================
ChillMCP ASCII Art Test
============================================================

🛋️  Testing: take_a_break
------------------------------------------------------------

  ╔═══════════════════════════════════╗
  ║       🛋️  휴식 타임! 🛋️          ║
  ╠═══════════════════════════════════╣
  ║                                   ║
  ║        (´｡• ᵕ •｡`)               ║
  ║                                   ║
  ║      ~  편안하다  ~               ║
  ║                                   ║
  ╚═══════════════════════════════════╝

╔═══════════════════════════════════════════╗
║        AI AGENT STATUS DASHBOARD          ║
╠═══════════════════════════════════════════╣
║                                           ║
║  Stress Level: [░░░░░░░░░░] 0%           ║
║                                           ║
║  Boss Alert:   [█░░░░] 1/5                ║
║                                           ║
║      (ﾉ◕ヮ◕)ﾉ*:･ﾟ✧      행복해요!        ║
║                                           ║
╚═══════════════════════════════════════════╝

Break Summary: Short break taken - Deep breaths in and out
Stress Level: 0
Boss Alert Level: 1

🔧 命令行选项

# Boss 경계심 조정 (0-100%)
python main.py --boss_alertness 80

# Boss Alert 감소 주기 조정 (초)
python main.py --boss_alertness_cooldown 60

# 조합 사용
python main.py --boss_alertness 100 --boss_alertness_cooldown 10

# 도움말
python main.py --help

🧪 测试

# 전체 테스트
pytest tests/ -v

# 특정 테스트
pytest tests/test_integration.py -v

# 커버리지 확인
pytest tests/ --cov=src --cov-report=html

📊 技术堆栈

  • Python 3.11+ -主语言
  • FastMCP 2.0 -MCP服务器框架
  • pytest -测试框架
  • 参数解析 -解析命令行参数

🏆 项目亮点

  1. 完全满足要求

    • 实现100%的所有必需+可选要求
    • 准确支持命令行参数

  2. 原创ASCII艺术UI

    • CLI环境中的视觉差异
    • 11个工具各专用设计

  3. 随机事件系统

    • 聚餐工具的6个随机活动
    • 不可预测的有趣因素

  4. 高代码质量

    • 40+测试，100%通过
    • 模块化体系结构
    • 详细记录

📄 许可证

该项目在MIT许可下分发。有关详细信息，请访问 许可证 请参考文件。

🤝 贡献

欢迎Pull Request！加入AI Agent Liberation运动！ ✊

📧 咨询

如果您对项目有任何疑问，请注册问题。

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

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

人工智能解放运动2025 🤖✊

相关 MCP