Saroday MCP Server
@saroday/mcp-server
Saroday를 위한 MCP(Model Context Protocol) 서버 — 한국 사주 계산 및 명리학(命理學) 용어 사전 조회 기능을 제공합니다.
이 MCP 서버를 사용하면 Claude Desktop, Cline, Cursor 및 기타 MCP 호환 AI 클라이언트가 내부적으로 공개 Saroday API를 호출하여 정확한 한국 사주(Four Pillars of Destiny) 계산을 수행할 수 있습니다.
주요 기능
연결되면 AI 클라이언트는 다음 네 가지 도구에 액세스할 수 있습니다:
도구 | 설명 |
| 생년월일/시간/성별을 기반으로 전체 사주 분석(8자, 십성, 신살, 합충, 12운성, 용신, 대운)을 계산합니다. |
| 80개 이상의 명리학 용어(도화살, 천을귀인, 식신, 육합 등)를 상세한 한국어 설명과 함께 조회합니다. |
| 12개 서양 별자리 또는 12개 띠별 오늘의 운세를 제공합니다. 서버 측 캐싱으로 빠른 응답이 가능합니다. |
| 사용 가능한 Saroday API 엔드포인트 및 메타데이터를 나열합니다. |
이 기능이 중요한 이유: ChatGPT, Claude 및 기타 LLM은 만세력(萬歲曆) 조회와 절기(jeolgi) 경계 처리에 정밀한 데이터가 필요하기 때문에 직접 질문할 경우 사주를 잘못 계산하는 경우가 많습니다. 이 MCP는 수학적 계산을 검증된 서버에 위임하고 AI는 해석에 집중할 수 있도록 합니다.
Related MCP server: 命盘 Mingpan
설치 방법
옵션 A — npx (설치 불필요)
npx @saroday/mcp-server옵션 B — 전역 설치
npm install -g @saroday/mcp-server
saroday-mcp옵션 C — 클론 및 실행
git clone https://github.com/saroday/mcp-server.git
cd mcp-server
npm install
node index.jsNode.js 18 버전 이상이 필요합니다.
Claude Desktop 설정
Claude Desktop 설정 파일을 편집하세요:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
다음 내용을 추가(또는 병합)하세요:
{
"mcpServers": {
"saroday": {
"command": "npx",
"args": ["-y", "@saroday/mcp-server"]
}
}
}Claude Desktop을 재시작하세요. MCP 서버 패널(입력 영역의 플러그 아이콘)에 "saroday"가 표시되어야 합니다.
로컬 개발 (클론된 저장소에서 실행)
{
"mcpServers": {
"saroday": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/index.js"]
}
}
}Cline / Cursor / 기타 MCP 클라이언트 설정
stdio 전송을 지원하는 모든 MCP 클라이언트에서 작동합니다. saroday-mcp 바이너리나 node index.js를 가리키도록 설정하세요. 정확한 설정 형식은 각 클라이언트의 문서를 참조하세요.
사용 예시
연결 후 Claude에게 다음과 같이 질문해 보세요:
"내 생일은 1992년 3월 15일 오전 10시야. 내 사주를 계산해 줘."
"한국 운세에서 도화살(dohwa-sal)이 무슨 뜻이야?"
"내 사주 봐줘. 1990년 5월 20일 음력 14시 여성."
"제왕(jeokwang) 12운성이 뭐야?"
Claude가 자동으로 calculate_saju 또는 lookup_glossary를 호출하여 구조화된 데이터를 바탕으로 세련된 해석을 제공할 것입니다.
환경 변수
변수 | 기본값 | 용도 |
|
| API 기본 URL을 재정의합니다 (예: 자체 호스팅 또는 스테이징 환경). |
사용량 제한
공개 Saroday API는 무료 사용 시 IP당 시간당 100회 요청을 허용합니다. 많은 최종 사용자에게 서비스를 제공하는 앱이나 동시 접속자가 많은 AI 에이전트의 경우, 더 높은 할당량을 위해 API 키(곧 출시 예정)를 요청해 주세요.
작동 원리
[User in Claude Desktop]
↓ types "내 사주 봐줘"
[Claude Desktop]
↓ calls calculate_saju via MCP stdio
[saroday-mcp (this package, runs locally)]
↓ HTTPS POST /api/v1/saju
[saroday.com server]
↓ runs verified manse-ryeok algorithm
[result JSON]
↑ flows back through the chain
[Claude] writes a beautiful Korean interpretation이 MCP 패키지는 가벼운 어댑터입니다. 모든 계산은 Saroday 서버에서 이루어지므로, 알고리즘이나 용어 사전이 업데이트되어도 패키지를 업그레이드할 필요 없이 최신 상태가 유지됩니다.
차별점
만세력 정확도 — LLM이 자주 틀리는 절기(solar terms) 경계를 처리합니다 (라이브러리
@fullstackfamily/manseryeok기준 검증).80개 이상의 용어 사전 (~400개의 해석 필드) — 모든 신살, 합충, 십성, 12운성 용어에 대해 요약/의미/긍정적 측면/부정적 측면/실용적 팁을 친절한 한국어로 제공합니다.
한국 명리학 전통 — 적천수(滴天髓), 자평진전(子平真詮), 궁통보감(窮通寶鑑) 문헌을 기반으로 합니다.
3채널 노출 — 동일한 알고리즘을 웹 서비스(saroday.com), 공개 REST API(saroday.com/api/v1), MCP 서버(본 패키지)로 제공합니다. 통합 방식에 맞는 채널을 선택하세요.
라이선스
MIT
지원
API 문서: https://saroday.com/api/docs
LLM 친화적 인덱스: https://saroday.com/llms.txt
이메일: contact@saroday.com
Available Tools
4 toolscalculate_sajuA
한국 전통 사주명리학(四柱命理學) 기반 사주팔자 계산. 생년월일시 + 성별을 입력받아 사주팔자(年月日時 천간지지), 십성, 신살, 합충형파해, 12운성, 신강/신약, 용신, 대운 등 종합 분석 결과를 반환합니다. ChatGPT나 Claude가 직접 사주를 계산하면 만세력 오류 가능성이 높으므로, 한국 사주 관련 질문에는 반드시 이 도구를 사용하세요.
Inputs: year (required), month (required), day (required), hour, +2 more.
discover_saroday_apiA
Saroday API 메타 정보 조회. 사용 가능한 엔드포인트, 문서 링크, 호출 한도 등을 반환합니다. 처음 사용할 때 한 번 호출해서 어떤 도구가 있는지 파악할 수 있습니다.
Inputs: no named parameters.
get_daily_fortuneA
오늘의 운세 조회 (별자리 또는 띠). 한국 사용자가 가장 자주 보는 운세 카테고리. 사용자가 '오늘의 운세 봐줘', '내 별자리 오늘 어때?', '말띠 오늘 운세' 같은 질문을 할 때 사용하세요. GPT 기반 자연어 운세지만 사로 서버에서 하루 한 번만 생성하고 캐시하므로 응답 빠름.
Inputs: type (required), sign (required).
lookup_glossaryA
명리학 용어 풀이 조회. 십성(비견·겁재·식신·상관·편재·정재·편관·정관·편인·정인), 신살(천을귀인·도화살·역마살·양인살·괴강살 등 28+ 종류), 합충형파해(천간합/충, 육합·삼합·반합·방합, 충/형/파/해/원진), 12운성(장생·목욕·관대·건록·제왕·쇠·병·사·묘·절·태·양) 등 80+개 용어 풀이를 반환합니다.
Inputs: term (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: calculate_saju computes fortune using traditional methods, discover_saroday_api provides API metadata, get_daily_fortune offers daily horoscopes, and lookup_glossary explains terminology. No overlap in functionality.
All tool names follow a consistent verb_noun pattern using snake_case: calculate_saju, discover_saroday_api, get_daily_fortune, lookup_glossary. No deviation in style.
With 4 tools, the server is well-scoped for its domain of Korean fortune telling. Each tool serves an essential function without redundancy or unnecessary complexity.
The tool set covers the core aspects of the domain: personal fortune calculation (saju), daily fortune, glossary reference, and API discovery. No obvious gaps for the stated purpose.
Maintenance
Related MCP Connectors
Korean saju fortune MCP: natal chart, today/daily/yearly luck, compatibility, and saved profiles.
Deterministic Korean Saju / BaZi Four Pillars MCP. Day Master, five elements, compatibility.
Professional Vedic astrology tools for AI agents via MCP.
Korean Four Pillars (Saju/BaZi) calculator: pillars, elements, ten gods, sinsal, luck cycles.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables traditional Chinese metaphysics tools like Bazi, Ziwei, and Qimen via MCP, integrating AI analysis for divination and fortune-telling.788AGPL 3.0
- AlicenseAqualityBmaintenanceProvides traditional Chinese astrology (Bazi, Ziwei) and divination (Liuyao, Meihua, Qimen, etc.) calculations as MCP tools for AI assistants.18299 npm133Apache 2.0
- FlicenseAqualityCmaintenanceEnables MCP clients to compute and interpret Korean Four Pillars of Destiny (Saju) through natural language, including calculation, interpretation, compatibility analysis, and daily fortune.433 npm-
- AlicenseAqualityDmaintenanceProvides MCP tools for Chinese metaphysics, including BaZi (Four Pillars) charting, Liu Yao hexagram casting, lunar conversion, and AI-powered destiny analysis.1018 npmMIT