Biocode Personality MCP Server

생년월일 기반 바이오코드 성격 분석 MCP (Model Context Protocol) 서버입니다.

개요

이 MCP 서버는 144가지 바이오코드를 기반으로 한 성격 분석 시스템을 제공합니다. 생년월일을 입력하면 해당하는 바이오코드를 계산하고, 긍정적/부정적 특성, 성격 요약, 조언, 관련 유명인 등의 정보를 제공합니다.

바이오코드 구조

• G코드 (G01-G12): 24절기 기반의 12개 계절 성격 유형
• S코드 (S10, S15, S20, S25, S30, S35, S40, S45, S50, S55, S60, S05): 12개의 부가 성격 특성
• 바이오코드: G코드 + S코드 = 4자리 코드 (예: 0110, 0520, 1260)
• 총 144개 조합 (12 G코드 × 12 S코드)

설치 및 사용

방법 1: NPX (권장)

NPM을 통해 직접 실행할 수 있습니다 (설치 불필요):

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "biocode-personality": {
      "command": "npx",
      "args": ["-y", "biocode-personality-mcp"]
    }
  }
}

방법 2: Docker (권장)

Docker Hub에서 사전 빌드된 이미지 사용:

{
  "mcpServers": {
    "biocode-personality": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "yakenator/biocode-personality-mcp:latest"]
    }
  }
}

Docker 이미지 pull:

docker pull yakenator/biocode-personality-mcp:latest

자세한 Docker 사용법은 DOCKER.md를 참조하세요.

방법 3: 로컬 설치

# 저장소 클론
git clone https://gitea.yakenator.io/sapiens/mcp_biocode.git
cd mcp_biocode

# 의존성 설치
npm install

# Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "biocode-personality": {
      "command": "node",
      "args": ["/path/to/mcp_biocode/index.js"]
    }
  }
}

방법 4: Smithery (준비 중)

Smithery를 통한 설치가 곧 지원될 예정입니다.

사용 가능한 도구

1. get_personality_by_birthdate

양력 생년월일을 기반으로 바이오코드를 계산하고 성격 분석 결과를 반환합니다.

입력:

• year (number): 출생 연도 (예: 1990)
• month (number): 출생 월 (1-12)
• day (number): 출생 일 (1-31)

출력 예시:

{
  "birthdate": "1990-05-15",
  "biocode": "1230",
  "code": "1230",
  "gCode": "G12",
  "season": "곡우(穀雨)",
  "seasonDescription": "G12는...",
  "positive": "긍정적 특성",
  "negative": "부정적 특성",
  "summary": "성격 요약",
  "advice": "조언",
  "famousPeople": [
    {
      "name": "유명인 이름",
      "code": "1230",
      "description": "설명"
    }
  ]
}

2. get_personality_by_code

4자리 바이오코드를 직접 입력하여 성격 분석 결과를 반환합니다.

입력:

• code (string): 4자리 바이오코드 (예: "0110", "0520", "1260")

출력: get_personality_by_birthdate와 동일한 형식 (birthdate 필드 제외)

3. list_all_codes

사용 가능한 모든 144개의 바이오코드 목록을 반환합니다.

입력: 없음

출력 예시:

[
  {
    "code": "0110",
    "gCode": "G01",
    "season": "입동(立冬)",
    "positive": "성실한 지도자다"
  },
  ...
]

4. get_personality_by_lunar_birthdate

음력 생년월일을 기반으로 바이오코드를 계산하고 성격 분석 결과를 반환합니다.

입력:

• year (number): 음력 출생 연도 (예: 1990)
• month (number): 음력 출생 월 (1-12)
• day (number): 음력 출생 일 (1-30)
• isLeapMonth (boolean, 선택): 윤달 여부 (기본값: false)

출력 예시:

{
  "birthdate": "양력 1990년 1월 27일",
  "biocode": "0635",
  "code": "0635",
  "gCode": "G06",
  "season": "대한(大寒)",
  "lunarBirthdate": "음력 1990년 1월 1일",
  "solarBirthdate": "양력 1990년 1월 27일",
  "positive": "긍정적 특성",
  "negative": "부정적 특성",
  "summary": "성격 요약",
  "advice": "조언",
  "famousPeople": [...]
}

데이터 구조

각 G코드별로 JSON 파일이 존재합니다:

• g01.json ~ g12.json

각 파일 구조:

{
  "metadata": {
    "gCode": "G01",
    "season": "입동(立冬)",
    "description": "G01은 성실하고 끈기있는 지도자 코드",
    "version": "1.0",
    "lastUpdated": "2025-12-06"
  },
  "codes": {
    "0110": {
      "positive": "성실한 지도자다",
      "negative": "남들에게 지나치게 근면과 복종을 강요하는가?",
      "summary": "끈기가 있고 집중적인 노력도...",
      "advice": "이 세상에 변하지 않는 것이란...",
      "famousPeople": [...]
    }
  }
}

24절기와 G코드 매핑

| G코드 | 절기 | 시작일 (양력 기준) | |------|------|------------------| | G01 | 입동(立冬) | 11월 7일경 | | G02 | 소설(小雪) | 11월 22일경 | | G03 | 대설(大雪) | 12월 7일경 | | G04 | 동지(冬至) | 12월 22일경 | | G05 | 소한(小寒) | 1월 6일경 | | G06 | 대한(大寒) | 1월 20일경 | | G07 | 입춘(立春) | 2월 4일경 | | G08 | 우수(雨水) | 2월 19일경 | | G09 | 경칩(驚蟄) | 3월 6일경 | | G10 | 춘분(春分) | 3월 21일경 | | G11 | 청명(淸明) | 4월 5일경 | | G12 | 곡우(穀雨) | 4월 20일경 |

바이오코드 계산 방식

이 MCP 서버는 정확한 바이오코드 계산을 위해 다음 방식을 사용합니다:

G코드 계산

• 음력 출생 연도 기준: 양력 생년월일을 음력으로 변환한 후, 음력 연도를 기준으로 12년 주기로 계산
• 기준년도: 1948년을 G12로 하여 12지 (십이지) 순환
• 예시: 음력 1972년 = G12 (쥐띠), 음력 1973년 = G01 (소띠)

S코드 계산

• 24절기 기준: 출생일 당시의 24절기를 정확히 계산
• 12개 주요 절기: 24절기 중 12개 節(절, jie) 절기만 사용
• 절기-코드 매핑: 각 절기 시작일부터 다음 절기 전까지 해당 S코드 적용

검증된 계산

• 1000년대부터 현재까지 모든 날짜 지원
• lunar-javascript 라이브러리를 사용한 정확한 음력/절기 계산
• 실제 인물 데이터로 검증 완료

배포

Docker Hub

• 이미지: yakenator/biocode-personality-mcp:latest
• URL: https://hub.docker.com/r/yakenator/biocode-personality-mcp

NPM (준비 중)

• 패키지명: biocode-personality-mcp

Smithery (준비 중)

• Smithery 배포 준비 완료

라이센스

MIT

저장소

• Gitea: https://gitea.yakenator.io/sapiens/mcp_biocode

버전

1.0.0