Saroday MCP Server
@saroday/mcp-server
MCP (Model Context Protocol) Server für Saroday — Koreanische Saju (사주) Berechnung und Myeongni-hak (命理學) Glossar-Suche.
Dieser MCP-Server ermöglicht es Claude Desktop, Cline, Cursor und jedem anderen MCP-kompatiblen KI-Client, präzise koreanische Saju-Berechnungen (Vier Säulen des Schicksals) durchzuführen, indem im Hintergrund die öffentliche Saroday-API aufgerufen wird.
Funktionsweise
Nach der Verbindung erhält der KI-Client Zugriff auf vier Tools:
Tool | Beschreibung |
| Berechnet die vollständige Saju-Analyse (8 Zeichen, Sipseong, Sinsal, Hapchung, 12-Unseong, Yongshin, Daeun) basierend auf Geburtsdatum / Uhrzeit / Geschlecht. |
| Schlägt einen von über 80 Myeongni-hak-Begriffen (도화살, 천을귀인, 식신, 육합 usw.) mit vollständiger koreanischer Erklärung nach. |
| Tageshoroskop für eines der 12 westlichen Sternzeichen oder 12 chinesischen Tierkreiszeichen. Serverseitig zwischengespeichert, schnelle Antwort. |
| Listet verfügbare Saroday-API-Endpunkte und Metadaten auf. |
Warum das wichtig ist: ChatGPT, Claude und andere LLMs berechnen Saju bei direkter Anfrage häufig falsch, da die Suche im Manse-ryeok (萬歲曆) und die Handhabung der 절기 (Jeolgi)-Grenzen präzise Daten erfordern. Dieses MCP delegiert die mathematischen Berechnungen an einen verifizierten Server, während die KI sich auf die Interpretation konzentrieren kann.
Related MCP server: 命盘 Mingpan
Installation
Option A — npx (keine Installation)
npx @saroday/mcp-serverOption B — Globale Installation
npm install -g @saroday/mcp-server
saroday-mcpOption C — Klonen und Ausführen
git clone https://github.com/saroday/mcp-server.git
cd mcp-server
npm install
node index.jsErfordert Node.js 18 oder neuer.
Claude Desktop konfigurieren
Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Fügen Sie Folgendes hinzu (oder führen Sie es zusammen):
{
"mcpServers": {
"saroday": {
"command": "npx",
"args": ["-y", "@saroday/mcp-server"]
}
}
}Starten Sie Claude Desktop neu. Sie sollten "saroday" im Bereich der MCP-Server sehen (das Stecker-Symbol im Eingabebereich).
Lokale Entwicklung (Ausführung aus dem geklonten Repository)
{
"mcpServers": {
"saroday": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/index.js"]
}
}
}Cline / Cursor / andere MCP-Clients konfigurieren
Jeder MCP-Client, der den stdio-Transport unterstützt, funktioniert. Verweisen Sie auf die saroday-mcp-Binärdatei oder node index.js. Informationen zum genauen Konfigurationsformat finden Sie in der Dokumentation Ihres Clients.
Ausprobieren
Fragen Sie Claude nach der Verbindung Dinge wie:
"Mein Geburtstag ist der 15. März 1992 um 10 Uhr morgens. Berechne mein koreanisches Saju."
"Was bedeutet 도화살 (dohwa-sal) in der koreanischen Wahrsagerei?"
"내 사주 봐줘. 1990년 5월 20일 음력 14시 여성."
"제왕(jeokwang) 12-unseong이 뭐야?"
Claude wird automatisch calculate_saju oder lookup_glossary aufrufen und Ihnen eine ausgefeilte Interpretation basierend auf den zurückgegebenen strukturierten Daten liefern.
Umgebungsvariablen
Variable | Standard | Zweck |
|
| Überschreibt die API-Basis-URL (z. B. für selbst gehostete oder Staging-Umgebungen). |
Ratenbegrenzungen
Die öffentliche Saroday-API erlaubt 100 Anfragen pro Stunde und IP für die kostenlose Nutzung. Nutzer mit hohem Aufkommen – Apps, die an viele Endnutzer ausgeliefert werden, oder KI-Agenten, die viele gleichzeitige Benutzer verarbeiten – sollten einen API-Schlüssel (in Kürze verfügbar) für höhere Kontingente anfordern.
Kontakt: contact@saroday.com
Funktionsweise
[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 interpretationDieses MCP-Paket ist ein schlanker Adapter – die gesamte Berechnung findet auf den Servern von Saroday statt, sodass Updates am Algorithmus oder Glossar bereitgestellt werden, ohne dass Sie das Paket aktualisieren müssen.
Alleinstellungsmerkmale
Manse-ryeok-Genauigkeit — verarbeitet 절기 (Sonnenbegriffe)-Grenzen, die LLMs routinemäßig falsch berechnen (verifiziert mit der
@fullstackfamily/manseryeok-Bibliothek)80+ Glossareinträge (~400 Interpretationsfelder) — jeder Sinsal-, Hapchung-, Sipseong- und 12-Unseong-Begriff enthält Zusammenfassung / Bedeutung / positive / negative / praktische Tipps in verständlichem Koreanisch
Koreanische Myeongni-hak-Tradition — basierend auf Referenzen wie 적천수(滴天髓), 자평진전(子平真詮) und 궁통보감(窮通寶鑑)
Drei-Kanal-Bereitstellung — derselbe Algorithmus ist als Webdienst (saroday.com), öffentliche REST-API (saroday.com/api/v1) und MCP-Server (dieses Paket) verfügbar. Wählen Sie den Kanal, der zu Ihrer Integration passt.
Lizenz
MIT
Support
Web: https://saroday.com
API-Dokumentation: https://saroday.com/api/docs
LLM-freundlicher Index: https://saroday.com/llms.txt
E-Mail: 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