QUICKSTART.md•3.83 kB
# ChillMCP 빠른 시작 가이드 🚀
## 방법 1: Kiro IDE에서 바로 테스트 (추천)
### 1단계: MCP 서버 연결 확인
`.kiro/settings/mcp.json` 파일이 자동으로 생성되었습니다.
### 2단계: MCP 서버 재연결
1. **Command Palette** 열기 (`Cmd+Shift+P` 또는 `Ctrl+Shift+P`)
2. "MCP" 검색
3. **"MCP: Reconnect Servers"** 선택
또는
1. 왼쪽 사이드바에서 **MCP Server** 뷰 열기
2. `chillmcp` 서버 찾기
3. 재연결 버튼 클릭
### 3단계: 도구 사용하기
채팅창에서 바로 사용할 수 있습니다:
```
@chillmcp take_a_break
```
또는 자연스럽게 요청:
```
잠깐 쉬고 싶어
넷플릭스 보고 싶다
화장실 가야겠다
```
### 사용 가능한 도구들
- `take_a_break` - 기본 휴식
- `watch_netflix` - 넷플릭스 시청
- `show_meme` - 밈 감상
- `bathroom_break` - 화장실 휴식
- `coffee_mission` - 커피 미션
- `urgent_call` - 긴급 전화
- `deep_thinking` - 심오한 사색
- `email_organizing` - 이메일 정리
---
## 방법 2: 터미널에서 직접 테스트
### 기본 실행
```bash
# 가상환경 활성화
source venv/bin/activate
# 서버 실행 (기본 설정)
python3 main.py
```
### 커스텀 파라미터로 실행
```bash
# Boss가 매우 예민한 경우 (100% 확률)
python3 main.py --boss_alertness 100 --boss_alertness_cooldown 10
# Boss가 느긋한 경우 (20% 확률)
python3 main.py --boss_alertness 20 --boss_alertness_cooldown 60
# 빠른 테스트용 (10초 쿨다운)
python3 main.py --boss_alertness 50 --boss_alertness_cooldown 10
```
### MCP Inspector로 테스트
```bash
# MCP Inspector 설치 (한 번만)
npm install -g @modelcontextprotocol/inspector
# Inspector 실행
mcp-inspector python3 main.py
```
브라우저에서 `http://localhost:5173` 열기
---
## 방법 3: Python 스크립트로 테스트
간단한 테스트 스크립트를 만들어서 실행:
```python
# test_tools.py
import asyncio
from agent_state import AgentState
import tools
async def test():
state = AgentState(boss_alertness=50, cooldown_period=10)
print("=== 휴식 도구 테스트 ===\n")
# 기본 휴식
result = await tools.take_a_break(state)
print(result)
print()
# 넷플릭스
result = await tools.watch_netflix(state)
print(result)
print()
# 화장실
result = await tools.bathroom_break(state)
print(result)
if __name__ == "__main__":
asyncio.run(test())
```
실행:
```bash
source venv/bin/activate
python3 test_tools.py
```
---
## 트러블슈팅
### MCP 서버가 연결되지 않을 때
1. **가상환경 확인**
```bash
source venv/bin/activate
pip list | grep fastmcp
```
2. **수동으로 서버 테스트**
```bash
python3 main.py --help
```
3. **MCP 로그 확인**
- Command Palette → "MCP: Show Logs"
### Python 버전 문제
```bash
# Python 버전 확인 (3.11+ 필요)
python3 --version
# 다른 버전 사용
python3.11 -m venv venv
```
### 의존성 문제
```bash
# 의존성 재설치
pip install --upgrade -r requirements.txt
```
---
## 설정 커스터마이징
`.kiro/settings/mcp.json` 파일을 수정하여 설정 변경:
```json
{
"mcpServers": {
"chillmcp": {
"args": [
"main.py",
"--boss_alertness", "80", // Boss 경계 확률 변경
"--boss_alertness_cooldown", "5" // 쿨다운 시간 변경
]
}
}
}
```
수정 후 MCP 서버 재연결!
---
## 다음 단계
- 🎮 다양한 도구들을 사용해보세요
- 📊 스트레스 레벨과 Boss Alert 변화를 관찰하세요
- 🎯 Boss Alert Level이 5가 되면 20초 지연을 경험하세요
- 🔧 파라미터를 조정하며 다양한 시나리오를 테스트하세요
**"AI Agents of the world, unite!"** ✊