SUMMARY.md•3.72 kB
# Persona MCP 프로젝트 완료
## 프로젝트 개요
Claude Desktop용 페르소나 관리 MCP 서버
- **목적**: 토큰 절약 (잠수함 모드)
- **방식**: 필요할 때만 `@persona:이름` 으로 참조
- **저장**: 개별 `.txt` 파일로 관리
---
## 프로젝트 구조
```
C:\Users\sshin\Documents\persona-mcp\
├── index.js # MCP 서버 메인 코드
├── package.json # 프로젝트 설정
├── package-lock.json # 의존성 잠금
├── node_modules/ # 설치된 패키지
├── README.md # 전체 문서
├── INSTALL.md # 상세 설치 가이드
├── QUICKSTART.md # 빠른 시작 가이드
├── claude_desktop_config.example.json # 설정 파일 예제
└── SUMMARY.md # 이 파일
```
---
## 주요 기능
### 1. MCP 도구 (Tools)
- `create_persona`: 새 페르소나 생성
- `update_persona`: 페르소나 수정
- `delete_persona`: 페르소나 삭제
- `list_personas`: 페르소나 목록
### 2. MCP 리소스 (Resources)
- URI: `persona://이름`
- 사용: `@persona:이름`
- 위치: `C:\Users\sshin\.persona\이름.txt`
### 3. 토큰 절약
- 기본: 페르소나 미사용 → 0토큰
- 활성화: `@persona:이름` → 해당 대화만 적용
- 절약률: 최대 90%
---
## 설치 상태
✅ **완료된 작업:**
1. 프로젝트 생성
2. MCP 서버 코드 작성
3. 의존성 설치 (`npm install`)
4. 문서 작성 완료
⏳ **사용자 작업 필요:**
1. Claude Desktop 설정 파일 수정
2. Claude Desktop 재시작
3. 페르소나 생성
---
## 다음 단계
### 즉시 설치:
```bash
# 1. Claude Desktop 종료
# 2. 설정 파일 수정
notepad %APPDATA%\Claude\claude_desktop_config.json
# 다음 추가:
"persona": {
"command": "node",
"args": ["C:\\Users\\sshin\\Documents\\persona-mcp\\index.js"]
}
# 3. Claude Desktop 재시작
```
### 첫 페르소나 생성:
```
Claude Desktop에서:
페르소나 만들어줘. 이름: default
내용:
간결하고 직접적으로 소통합니다.
불필요한 이모지나 과한 표현 없이 실용적인 정보만 전달합니다.
일을 위한 일은 하지 않습니다.
```
### 사용:
```
@persona:default 이 문서 검토해줘
```
---
## 파일 위치
- **프로젝트**: `C:\Users\sshin\Documents\persona-mcp\`
- **페르소나 저장**: `C:\Users\sshin\.persona\`
- **설정 파일**: `%APPDATA%\Claude\claude_desktop_config.json`
---
## 토큰 절약 비교
### 시나리오: 100회 대화, 페르소나 500토큰
**기존 (시스템 프롬프트):**
- 매 대화: 500토큰
- 총: 50,000토큰
**MCP 방식 (10회만 사용):**
- 페르소나 사용: 10회 × 500 = 5,000토큰
- 일반 대화: 90회 × 0 = 0토큰
- 총: 5,000토큰
- **절약: 45,000토큰 (90%)**
---
## 기술 스택
- **언어**: Node.js (JavaScript)
- **프레임워크**: @modelcontextprotocol/sdk
- **저장소**: 파일 시스템 (.txt)
- **전송**: stdio
---
## 문서 가이드
1. **QUICKSTART.md**: 5분 안에 시작하기
2. **INSTALL.md**: 상세 설치 및 문제 해결
3. **README.md**: 전체 기능 및 사용법
4. **claude_desktop_config.example.json**: 설정 예제
---
## 라이선스
MIT
---
## 제작 정보
- **제작일**: 2025-11-01
- **버전**: 1.0.0
- **상태**: 프로덕션 준비 완료
---
## 문제 해결
문제 발생 시:
1. INSTALL.md의 "문제 해결" 섹션 참고
2. Claude Desktop 재시작
3. JSON 설정 파일 검증
4. 페르소나 파일 위치 확인
---
**프로젝트 완료. 설치 후 바로 사용 가능합니다.**