SETUP.md•3.92 kB
# ChillMCP 설치 가이드 🛠️
## 1. 프로젝트 클론 및 의존성 설치
```bash
# 프로젝트 클론
git clone <repository-url>
cd devotion-mcp
# Python 가상환경 생성
python3 -m venv venv
# 가상환경 활성화
source venv/bin/activate # macOS/Linux
# venv\Scripts\activate # Windows
# 의존성 설치
pip install -r requirements.txt
```
## 2. MCP 서버 설정
### 방법 A: 자동 설정 (추천)
예시 파일을 복사하여 사용:
```bash
# .kiro/settings 디렉토리가 없으면 생성
mkdir -p .kiro/settings
# 예시 파일 복사
cp .kiro/settings/mcp.json.example .kiro/settings/mcp.json
```
### 방법 B: 수동 설정
`.kiro/settings/mcp.json` 파일을 직접 생성:
```json
{
"mcpServers": {
"chillmcp": {
"command": "python3",
"args": [
"main.py",
"--boss_alertness",
"50",
"--boss_alertness_cooldown",
"10"
],
"cwd": "${workspaceFolder}",
"env": {
"PYTHONPATH": "${workspaceFolder}",
"PATH": "${workspaceFolder}/venv/bin:${env:PATH}"
},
"disabled": false,
"autoApprove": [
"take_a_break",
"watch_netflix",
"show_meme",
"bathroom_break",
"coffee_mission",
"urgent_call",
"deep_thinking",
"email_organizing"
]
}
}
}
```
## 3. Kiro IDE에서 MCP 서버 연결
1. **Command Palette** 열기 (`Cmd+Shift+P` 또는 `Ctrl+Shift+P`)
2. **"MCP: Reconnect Servers"** 입력 후 선택
3. MCP Logs에서 연결 확인
## 4. 테스트
채팅창에서 테스트:
```
@chillmcp take_a_break
```
또는 자연스럽게:
```
잠깐 쉬고 싶어
```
---
## 트러블슈팅
### 문제 1: `spawn python3 ENOENT` 에러
**원인:** `python3` 명령어를 찾을 수 없음
**해결 방법:**
#### Option A: 절대 경로 사용 (가장 확실)
```bash
# Python 경로 확인
which python3
```
`.kiro/settings/mcp.json`에서 절대 경로 사용:
```json
{
"mcpServers": {
"chillmcp": {
"command": "/절대/경로/to/venv/bin/python3",
"args": ["/절대/경로/to/main.py", ...]
}
}
}
```
#### Option B: Shell 래퍼 사용
`run_server.sh` 파일 생성:
```bash
#!/bin/bash
cd "$(dirname "$0")"
source venv/bin/activate
exec python3 main.py "$@"
```
실행 권한 부여:
```bash
chmod +x run_server.sh
```
`.kiro/settings/mcp.json` 수정:
```json
{
"mcpServers": {
"chillmcp": {
"command": "${workspaceFolder}/run_server.sh",
"args": ["--boss_alertness", "50", "--boss_alertness_cooldown", "10"]
}
}
}
```
### 문제 2: 모듈을 찾을 수 없음 (ModuleNotFoundError)
**원인:** 가상환경이 활성화되지 않았거나 의존성이 설치되지 않음
**해결 방법:**
```bash
source venv/bin/activate
pip install -r requirements.txt
```
### 문제 3: `${workspaceFolder}` 변수가 해석되지 않음
**원인:** 일부 환경에서 변수 해석이 안 될 수 있음
**해결 방법:** 절대 경로 사용 (Option A 참고)
---
## 파라미터 커스터마이징
`.kiro/settings/mcp.json`에서 파라미터 조정:
```json
{
"mcpServers": {
"chillmcp": {
"args": [
"main.py",
"--boss_alertness", "80", // Boss 경계 확률 (0-100)
"--boss_alertness_cooldown", "5" // 쿨다운 시간 (초)
]
}
}
}
```
### 파라미터 설명
- `--boss_alertness`: Boss가 의심하는 확률 (0-100%)
- `0`: Boss가 전혀 의심하지 않음
- `50`: 기본값, 50% 확률
- `100`: 항상 의심함 (테스트용)
- `--boss_alertness_cooldown`: Boss Alert Level 감소 주기 (초)
- `10`: 빠른 테스트용
- `60`: 1분마다 감소
- `300`: 기본값, 5분마다 감소
---
## 다음 단계
설정이 완료되었다면 [QUICKSTART.md](QUICKSTART.md)를 참고하여 사용을 시작하세요!
**"AI Agents of the world, unite!"** ✊