Big 5 Personality Consulting MCP Server

Claude Desktop용 Big 5 성격검사 및 종합 컨설팅 MCP 서버

기능 개요

5가지 MCP Tools

1. manage_survey - 성격검사 관리

• start: 검사 시작 (전체 60문항 또는 간략 30문항 선택 가능, 첫 5문항 랜덤 제공)
• submit: 답변 제출 (5문항씩 배치, 랜덤 순서)
• resume: 중단된 검사 재개
• progress: 진행 상황 확인

특징:

• 랜덤 출제: 질문이 랜덤 순서로 제공되어 측정 항목(개방성, 성실성 등)이 노출되지 않음
• 간략 버전: 30문항(각 특성당 6문항, 6가지 하위요인 × 1문항)으로 빠른 검사 가능
• 전체 버전: 60문항(각 특성당 12문항, 6가지 하위요인 × 2문항)으로 정밀한 측정
• 6가지 하위요인:
  • 개방성: 상상력, 심미성, 감정, 행동, 아이디어, 가치관
  • 성실성: 능력, 질서, 의무감, 성취추구, 자기통제, 신중성
  • 외향성: 온정, 사교성, 주장성, 활동성, 자극추구, 긍정적 정서
  • 친화성: 신뢰, 솔직함, 이타심, 순응성, 겸손, 동정심
  • 신경증: 불안, 적대감, 우울, 자의식, 충동성, 스트레스 취약성

2. manage_profile - 프로필 관리

• create: 프로필 생성
• get: 프로필 조회
• update: 프로필 수정
• delete: 프로필 삭제
• list: 전체 프로필 목록

3. analyze_individual - 개인 분석

• personality: 전반적 성격 분석
• strengths_weaknesses: 강점과 약점 분석
• career: 직업 추천 및 커리어 조언
• development: 자기계발 전략
• learning_style: 학습 스타일 분석
• stress_management: 스트레스 관리 전략

4. analyze_team - 팀 분석

• composition: 팀 구성 분석 (다양성, 균형)
• roles: 역할 배분 추천
• conflicts: 갈등 예측 및 예방
• communication: 소통 스타일 분석
• collaboration: 협업 전략 제안

5. analyze_relationship - 관계 분석

• compatibility: 호환성 분석 (업무/개인/연애)
• communication_style: 소통 방법 제안
• dynamics: 관계 역학 분석 (권력, 영향력, 의사결정)

설치

Smithery를 통한 설치 (권장)

가장 쉬운 방법은 Smithery를 통한 설치입니다:

npx @smithery/cli install @hjsh200219/big5-consulting --client claude

또는 Smithery 웹사이트에서 "Install in Claude Desktop" 버튼을 클릭하세요.

수동 설치

git clone https://github.com/hjsh200219/big5-consulting.git
cd big5-consulting
npm install
npm run build

Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json 파일에 다음 내용을 추가:

기본 설정 (On-Demand Loading)

{
  "mcpServers": {
    "big5": {
      "command": "node",
      "args": [
        "/Users/hoshin/workspace/big5-consulting/dist/index.js"
      ]
    }
  }
}

Lazy Loading 모드 사용 (선택)

모든 도구를 첫 호출 시 한번에 로드하려면:

{
  "mcpServers": {
    "big5": {
      "command": "node",
      "args": [
        "/Users/hoshin/workspace/big5-consulting/dist/index.js"
      ],
      "env": {
        "BIG5_LAZY_LOAD_SCHEMAS": "true"
      }
    }
  }
}

설정 후 Claude Desktop을 재시작하세요.

사용 예시

1. 성격검사 진행

전체 버전 (60문항, 기본값)

검사 시작:

검사를 시작하고 싶어요. 제 이름은 홍길동입니다.

Claude가 자동으로 manage_survey 도구를 사용하여 60문항 중 첫 5문항을 랜덤으로 제공합니다.

간략 버전 (30문항)

검사 시작:

간략 버전으로 검사를 시작하고 싶어요. 제 이름은 홍길동입니다.

Claude가 30문항(각 특성당 6문항, 6가지 하위요인 측정) 중 첫 5문항을 랜덤으로 제공합니다.

답변 제출:

4,5,3,4,5

5개의 답변을 쉼표로 구분하여 입력하면, 다음 질문으로 넘어갑니다.

• 전체 버전: 총 12회(60문항 / 5문항) 제출
• 간략 버전: 총 6회(30문항 / 5문항) 제출

검사 재개:

이전에 진행하던 검사를 계속하고 싶어요. 세션 ID는 survey_xxx입니다.

진행 상황 확인:

현재 검사 진행 상황을 알려주세요.

2. 개인 분석

성격 분석:

제 성격을 분석해주세요. (프로필 ID: prof_xxx)

강점과 약점:

제 강점과 약점을 알려주세요.

직업 추천:

저에게 맞는 직업을 추천해주세요. 현재 IT 업계에서 일하고 있습니다.

학습 스타일:

제 학습 스타일을 분석해주세요.

스트레스 관리:

스트레스를 관리하는 방법을 추천해주세요.

3. 팀 분석

팀 구성 분석:

우리 팀의 구성을 분석해주세요.
프로필 ID: prof_001, prof_002, prof_003, prof_004

역할 배분:

이 프로젝트에서 각 팀원의 역할을 추천해주세요.
프로젝트 유형: 신제품 개발

갈등 예측:

팀 내 갈등 가능성을 분석해주세요.

협업 전략:

우리 팀의 협업을 개선할 방법을 제안해주세요.

4. 관계 분석

호환성 분석:

저와 제 동료의 업무 호환성을 분석해주세요.
프로필 A: prof_001
프로필 B: prof_002
맥락: work

소통 방법:

우리 둘의 소통 방법을 제안해주세요.

관계 역학:

멘토-멘티 관계의 역학을 분석해주세요.

데이터 저장

모든 데이터는 ~/.big5/ 디렉토리에 JSON 파일로 저장됩니다:

~/.big5/
├── profiles/           # 완료된 프로필
│   ├── prof_abc123.json
│   └── prof_def456.json
└── surveys/            # 진행 중인 검사 세션
    ├── survey_abc123.json
    └── survey_def456.json

데이터 백업

# 프로필 백업
cp -r ~/.big5/profiles ~/backup/big5-profiles-$(date +%Y%m%d)

# 전체 백업
tar -czf ~/backup/big5-backup-$(date +%Y%m%d).tar.gz ~/.big5

개발

# 개발 모드 실행 (자동 재시작)
npm run dev

# 빌드
npm run build

# 프로덕션 실행
npm start

기술 스택

• 언어: TypeScript
• MCP SDK: @modelcontextprotocol/sdk v1.20.0
• 저장소: 파일 시스템 (JSON) + 메모리 캐시
• 분석 엔진: 규칙 기반 의사결정 트리
• 아키텍처: On-Demand Loading 패턴 (Dynamic Import)

성능 최적화

로딩 전략 선택

1. On-Demand Loading (기본값, 권장)

BIG5_LAZY_LOAD_SCHEMAS=false  # 또는 설정하지 않음

• 개별 로드: 각 도구는 실제 호출될 때만 동적 import
• 메모리 효율: 미사용 도구는 절대 로드 안됨
• 적합한 경우: 특정 도구만 주로 사용하는 경우 (예: survey만)

성능 지표:

• 서버 시작: < 50ms
• 첫 도구 호출: 50-100ms (import), 이후 < 10ms
• 메모리: 기본 ~30MB, 도구당 +10-15MB

2. Lazy Loading (선택적)

BIG5_LAZY_LOAD_SCHEMAS=true

• 일괄 로드: 첫 tool 호출 시 모든 5개 도구를 한번에 로드
• 빠른 후속 호출: 모든 도구가 메모리에 있어 즉시 실행
• 적합한 경우: 모든 도구를 골고루 사용하는 경우

성능 지표:

• 서버 시작: < 50ms
• 첫 호출: 100-150ms (모든 도구 import), 이후 < 10ms
• 메모리: 첫 호출 후 즉시 ~100MB

공통 성능 지표

• Tool 응답 시간: < 200ms (p95)
• 캐시 히트율: > 90%
• 동시 사용자: 지원
• 파일 I/O: 최적화된 배치 처리

라이선스

ISC

문의 및 기여

이슈와 PR은 GitHub 저장소에서 환영합니다.