MCP server for biocode personality analysis based on birthdate, lunar calendar, and 24 solar terms
생년월일 기반 바이오코드 성격 분석 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코드)
NPM을 통해 직접 실행할 수 있습니다 (설치 불필요):
~/Library/Application Support/Claude/claude_desktop_config.json:
``json`
{
"mcpServers": {
"biocode-personality": {
"command": "npx",
"args": ["-y", "biocode-personality-mcp"]
}
}
}
Docker Hub에서 사전 빌드된 이미지 사용:
`json`
{
"mcpServers": {
"biocode-personality": {
"command": "docker",
"args": ["run", "-i", "--rm", "yakenator/biocode-personality-mcp:latest"]
}
}
}
Docker 이미지 pull:
`bash`
docker pull yakenator/biocode-personality-mcp:latest
자세한 Docker 사용법은 DOCKER.md를 참조하세요.
`bash저장소 클론
git clone https://gitea.yakenator.io/sapiens/mcp_biocode.git
cd mcp_biocode
:`json
{
"mcpServers": {
"biocode-personality": {
"command": "node",
"args": ["/path/to/mcp_biocode/index.js"]
}
}
}
`$3
Smithery를 통한 설치가 곧 지원될 예정입니다.
사용 가능한 도구
$3
양력 생년월일을 기반으로 바이오코드를 계산하고 성격 분석 결과를 반환합니다.
입력:
-
(number): 출생 연도 (예: 1990)
- month (number): 출생 월 (1-12)
- day (number): 출생 일 (1-31)출력 예시:
`json
{
"birthdate": "1990-05-15",
"biocode": "1230",
"code": "1230",
"gCode": "G12",
"season": "곡우(穀雨)",
"seasonDescription": "G12는...",
"positive": "긍정적 특성",
"negative": "부정적 특성",
"summary": "성격 요약",
"advice": "조언",
"famousPeople": [
{
"name": "유명인 이름",
"code": "1230",
"description": "설명"
}
]
}
`$3
4자리 바이오코드를 직접 입력하여 성격 분석 결과를 반환합니다.
입력:
-
(string): 4자리 바이오코드 (예: "0110", "0520", "1260")출력: get_personality_by_birthdate와 동일한 형식 (birthdate 필드 제외)
$3
사용 가능한 모든 144개의 바이오코드 목록을 반환합니다.
입력: 없음
출력 예시:
`json
[
{
"code": "0110",
"gCode": "G01",
"season": "입동(立冬)",
"positive": "성실한 지도자다"
},
...
]
`$3
음력 생년월일을 기반으로 바이오코드를 계산하고 성격 분석 결과를 반환합니다.
입력:
-
(number): 음력 출생 연도 (예: 1990)
- month (number): 음력 출생 월 (1-12)
- day (number): 음력 출생 일 (1-30)
- isLeapMonth (boolean, 선택): 윤달 여부 (기본값: false)출력 예시:
`json
{
"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 파일이 존재합니다:
-
~ g12.json각 파일 구조:
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 서버는 정확한 바이오코드 계산을 위해 다음 방식을 사용합니다:
$3
- 음력 출생 연도 기준: 양력 생년월일을 음력으로 변환한 후, 음력 연도를 기준으로 12년 주기로 계산
- 기준년도: 1948년을 G12로 하여 12지 (십이지) 순환
- 예시: 음력 1972년 = G12 (쥐띠), 음력 1973년 = G01 (소띠)$3
- 24절기 기준: 출생일 당시의 24절기를 정확히 계산
- 12개 주요 절기: 24절기 중 12개 節(절, jie) 절기만 사용
- 절기-코드 매핑: 각 절기 시작일부터 다음 절기 전까지 해당 S코드 적용$3
- 1000년대부터 현재까지 모든 날짜 지원
- lunar-javascript 라이브러리를 사용한 정확한 음력/절기 계산
- 실제 인물 데이터로 검증 완료배포
$3
- 이미지:
- URL: https://hub.docker.com/r/yakenator/biocode-personality-mcp$3
- 패키지명: MIT
- Gitea: https://gitea.yakenator.io/sapiens/mcp_biocode
1.0.0