MCP 服务器

mcp-novel-calc

Provides calculations for novel writing including dates, traditional units, currency, travel time, and growth rates, helping AI avoid arithmetic errors in fiction.

README

mcp-novel-calc

소설 집필용 계산기 MCP 서버. 날짜/요일, 수학, 속도/거리, 동양 전통 단위, 십이지시, 화폐, 군량, 성장률 등을 정확하게 계산합니다.

AI가 산수를 틀리는 문제를 해결하기 위해 만들었습니다. 무협, 판타지, 회귀물 등 숫자가 중요한 장르에 특히 유용합니다.

도구 목록

도구	설명	예시
`calculate`	수학 수식 계산	`1250 * 1.35` → `1687.5`
`date_calc`	날짜 더하기/빼기	`2020-03-12 + 365일` → `2021-03-12 (금요일)`
`date_diff`	두 날짜 차이	→ `1699일, 약 4.7년`
`d_plus`	D-Day 기준 변환	`D+100` → `2020-06-20 (토요일)`
`weekday`	요일/달력 조회	`2020-03-12` → `목요일, 달력 표시`
`convert_time`	십이지시 ↔ 현대 시각	`14:30` → `미시(未時) 사각`
`speed_distance_time`	속도·거리·시간	2개 입력 → 나머지 계산
`travel_estimate`	이동 수단별 소요 시간	`100km, 천리마` → `2.2시간`
`unit_convert`	단위 변환	`10리` → `3.93km`
`currency_calc`	화폐 단위 변환 (무협)	`3.5냥` → `3냥 5전`
`supply_calc`	군량/보급 계산	`1000명, 10섬` → `3.3일`
`growth_calc`	복리/성장률 계산	`100→300, 1.5%/일` → `74일`

설치

요구사항

Python 3.10+
mcp 패키지

git clone https://github.com/NA-DEGEN-GIRL/mcp-novel-calc.git
cd mcp-novel-calc
pip install -r requirements.txt

Claude Code에 등록

프로젝트의 .mcp.json에 추가:

{
  "mcpServers": {
    "novel-calc": {
      "command": "python3",
      "args": ["/path/to/mcp-novel-calc/calc_server.py"]
    }
  }
}

Claude Desktop에 등록

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "novel-calc": {
      "command": "python3",
      "args": ["/path/to/mcp-novel-calc/calc_server.py"]
    }
  }
}

사용 예시

날짜 계산

> d_plus(d_day="2020-03-12", target="100")

D+0 = 2020년 3월 12일 (목요일)
D+100 = 2020년 6월 20일 (토요일) (2020-06-20)

십이지시 변환

> convert_time("14:30")

14:30 = 미시(未時) 사각(四刻)
범위: 13:00 ~ 15:00

> convert_time("자시")

자시(子時) = 23:00 ~ 익일 01:00 (약 2시간)
초각(初刻) = 23:00, 이각 = 23:30, 삼각 = 00:00, 사각 = 00:30
십이지: 쥐

이동 시간 추정

> travel_estimate(distance=100, mode="천리마")

이동 수단: 천리마(질주) (45.0km/h)
이동 거리: 100.0km (약 255리)
순수 이동: 2.2시간
동양식: 약 1.1시진(時辰)
📝 "255리 길을 천리마(질주)으로 달리면 2.2시간 정도 걸린다."

군량 계산

> supply_calc(people=1000, consumption_per_day=3, consumption_unit="홉", supply_amount=10, supply_unit="섬")

인원: 1,000명
1인 1일 소비: 3 홉 (3홉)
전체 1일 소비: 3,000홉 = 30.0말 = 3.00섬
보유량: 10 섬 (10,000홉)
버틸 수 있는 일수: 3.3일

화폐 변환

> currency_calc(3.5, "냥")

3.5 냥 = 3,500 푼(문)
분해: 3냥 5전

── 참고 물가 (무협 일반 설정) ──
  국수 한 그릇: 5~10문
  객잔 1박: 50~100문
  평범한 검: 2~5냥
  좋은 말 한 필: 10~30냥

성장률 계산

> growth_calc(start_value=100, target_value=300, daily_rate=1.5)

시작: 100.0 → 목표: 300.0 (3.0배)
성장률: 일 1.5%
필요 기간: 74일 (약 2.5개월)
📝 "매일 1.5%씩 수련하면 74일이면 300에 도달한다."