158 lines
3.8 KiB
Markdown
158 lines
3.8 KiB
Markdown
|
# GPTEdit MCP Connector 설정 가이드
|
||
|
|
|
||
|
|
## 📍 Claude Desktop 설정 파일 위치
|
||
|
|
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
|
||
|
|
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
||
|
|
- **Linux**: `~/.config/claude/claude_desktop_config.json`
|
||
|
|
|
||
|
|
## ⚙️ MCP Connector 설정
|
||
|
|
|
||
|
|
### 기본 설정 (Python 직접 실행)
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"mcpServers": {
|
||
|
|
"gptedit": {
|
||
|
|
"command": "python",
|
||
|
|
"args": ["D:\\Project\\little-fairy\\gptedit\\main.py"],
|
||
|
|
"env": {
|
||
|
|
"PYTHONPATH": "D:\\Project\\little-fairy\\gptedit"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### 가상환경 사용 시
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"mcpServers": {
|
||
|
|
"gptedit": {
|
||
|
|
"command": "D:\\Project\\little-fairy\\gptedit\\venv\\Scripts\\python.exe",
|
||
|
|
"args": ["D:\\Project\\little-fairy\\gptedit\\main.py"],
|
||
|
|
"env": {
|
||
|
|
"PYTHONPATH": "D:\\Project\\little-fairy\\gptedit"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### 배치 파일 사용 시
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"mcpServers": {
|
||
|
|
"gptedit": {
|
||
|
|
"command": "cmd",
|
||
|
|
"args": ["/c", "D:\\Project\\little-fairy\\gptedit\\run.bat"]
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🔧 환경 변수 설정 (선택사항)
|
||
|
|
|
||
|
|
MCP connector에서 직접 환경 변수를 설정할 수도 있습니다:
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"mcpServers": {
|
||
|
|
"gptedit": {
|
||
|
|
"command": "python",
|
||
|
|
"args": ["D:\\Project\\little-fairy\\gptedit\\main.py"],
|
||
|
|
"env": {
|
||
|
|
"PYTHONPATH": "D:\\Project\\little-fairy\\gptedit",
|
||
|
|
"OPENAI_API_KEY": "sk-xxxxx",
|
||
|
|
"OUTPUT_FILENAME_PREFIX": "gptimage1",
|
||
|
|
"GENERATED_IMAGES_PATH": "D:\\Project\\little-fairy\\gptedit\\generated_images",
|
||
|
|
"LOG_LEVEL": "INFO",
|
||
|
|
"MAX_IMAGE_SIZE_MB": "4",
|
||
|
|
"DEFAULT_TIMEOUT": "30",
|
||
|
|
"ENABLE_AUTO_OPTIMIZE": "true",
|
||
|
|
"SAVE_ORIGINALS": "true",
|
||
|
|
"SAVE_PARAMETERS": "true"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## 📝 다중 MCP 서버 설정
|
||
|
|
|
||
|
|
여러 MCP 서버를 함께 사용하는 경우:
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"mcpServers": {
|
||
|
|
"gptedit": {
|
||
|
|
"command": "python",
|
||
|
|
"args": ["D:\\Project\\little-fairy\\gptedit\\main.py"]
|
||
|
|
},
|
||
|
|
"filesystem": {
|
||
|
|
"command": "npx",
|
||
|
|
"args": ["-y", "@modelcontextprotocol/server-filesystem", "D:\\Project\\little-fairy"]
|
||
|
|
},
|
||
|
|
"imagen4": {
|
||
|
|
"command": "python",
|
||
|
|
"args": ["D:\\Project\\imagen4\\main.py"]
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🚨 주의사항
|
||
|
|
|
||
|
|
1. **경로 구분자**: Windows에서는 `\\` 또는 `/` 모두 사용 가능
|
||
|
|
2. **Python 경로**: 시스템 Python 또는 가상환경 Python 경로 확인
|
||
|
|
3. **권한**: 스크립트 실행 권한 확인
|
||
|
|
4. **로그 확인**: 문제 발생 시 `gptedit.log` 파일 확인
|
||
|
|
|
||
|
|
## 🔍 연결 테스트
|
||
|
|
|
||
|
|
Claude Desktop에서 다음 명령으로 연결 확인:
|
||
|
|
|
||
|
|
1. **도구 목록 확인**:
|
||
|
|
- Claude에게 "What tools are available?" 물어보기
|
||
|
|
- `edit_image`, `edit_with_mask`, `batch_edit` 등이 나타나야 함
|
||
|
|
|
||
|
|
2. **간단한 테스트**:
|
||
|
|
```
|
||
|
|
"Validate the image at D:/test.png"
|
||
|
|
```
|
||
|
|
|
||
|
|
3. **로그 확인**:
|
||
|
|
- `D:\Project\little-fairy\gptedit\gptedit.log` 파일에서 연결 로그 확인
|
||
|
|
|
||
|
|
## 🔄 서버 재시작
|
||
|
|
|
||
|
|
설정 변경 후:
|
||
|
|
1. Claude Desktop 완전 종료 (시스템 트레이 확인)
|
||
|
|
2. Claude Desktop 재시작
|
||
|
|
3. 새 대화 시작
|
||
|
|
|
||
|
|
## 📋 체크리스트
|
||
|
|
|
||
|
|
- [ ] `.env` 파일에 OPENAI_API_KEY 설정됨
|
||
|
|
- [ ] `generated_images/` 디렉토리 존재
|
||
|
|
- [ ] Python 및 필요 패키지 설치됨
|
||
|
|
- [ ] `claude_desktop_config.json` 파일 설정됨
|
||
|
|
- [ ] Claude Desktop 재시작됨
|
||
|
|
|
||
|
|
## 🐛 문제 해결
|
||
|
|
|
||
|
|
### "Server disconnected" 에러
|
||
|
|
1. Python 경로 확인
|
||
|
|
2. 의존성 설치 확인: `pip install -r requirements.txt`
|
||
|
|
3. `.env` 파일 확인
|
||
|
|
|
||
|
|
### "Method not found" 에러
|
||
|
|
1. 최신 코드인지 확인
|
||
|
|
2. `list_prompts`, `list_resources` 메서드 구현 확인
|
||
|
|
|
||
|
|
### 파일을 찾을 수 없음
|
||
|
|
1. `generated_images/` 디렉토리 생성 확인
|
||
|
|
2. 파일 권한 확인
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
이 가이드를 따라 Claude Desktop과 GPTEdit MCP 서버를 연결하세요.
|