mcp-biorhythm

생년월일을 받아 바이오리듬 수치 + 사인파 차트(PNG) 를 반환하는 MCP 서버. "내 바이오리듬 보여줘"라고 하면 신체·감성·지성 세 곡선 그래프 이미지를 돌려준다.

구조·네이밍·PNG·설치 규약은 STANDARD.md를 따른다. mcp-qr skeleton 복제본.

---

계산 (결정론적)

고전 3주기 · 값 = sin(2π × d / period) (d = 출생일로부터 경과 일수):

사이클	주기
신체 (Physical)	23일
감성 (Emotional)	28일
지성 (Intellectual)	33일

• 출력은 백분율(−100% ~ +100%).
• 임계일(critical day): 곡선이 0을 교차(부호가 바뀌는)하는 불안정일. 구간 내 목록으로 표시.
• 날짜는 UTC 자정 기준으로 계산 → 타임존에 따른 ±1일 오차 없음.

---

도구

get_biorhythm

파라미터	타입	필수	기본	설명
birthDate	string YYYY-MM-DD	✅	—	생년월일
targetDate	string YYYY-MM-DD		오늘(UTC)	기준일
rangeDays	number		15	기준일 전후 표시 일수 (1–90)

출력 (둘 다 반환):

1. 구조화 텍스트 — 기준일의 신체/감성/지성 백분율 + 상승/하강 + 구간 내 임계일 목록
2. PNG 차트 — [targetDate − rangeDays, targetDate + rangeDays] 구간의 세 곡선 (1080×620)

예제 출력: examples/biorhythm_example.png (1990-05-15 출생 · 2026-06-19 기준, 기본 옵션).

---

설치

git clone https://github.com/molpass/mcp-biorhythm.git
cd mcp-biorhythm
npm install && npm run build

예제 차트를 직접 생성해 보려면:

npm run example   # examples/biorhythm_example.png 재생성

폰트: 한글 라벨(신체/감성/지성)을 위해 한글 가능 폰트가 필요하다. Windows는 Malgun Gothic이 기본 탑재라 추가 설치 불필요. Linux는 Nanum/Noto CJK 설치 권장.

---

MCP 등록 (서버명 biorhythm)

{
  "mcpServers": {
    "biorhythm": {
      "command": "node",
      "args": ["/abs/path/mcp-biorhythm/dist/index.js"]
    }
  }
}

/abs/path는 클론한 실제 절대경로로 바꾼다. Windows 예: "args": ["C:/Users/<you>/mcp-biorhythm/dist/index.js"]

---

스택

• Node 20+ / TypeScript
• @modelcontextprotocol/sdk (stdio)
• @napi-rs/canvas (차트 → PNG, prebuilt 바이너리)

스킬

페어링 스킬: skill/biorhythm.skill.md.

License

MIT