loading…
Search for a command to run...
loading…
Enables Korean Saju (Four Pillars of Destiny) calculation and myeongni-hak glossary lookup via MCP, allowing AI clients to compute accurate saju analysis and lo
Enables Korean Saju (Four Pillars of Destiny) calculation and myeongni-hak glossary lookup via MCP, allowing AI clients to compute accurate saju analysis and look up fortune-telling terms.
MCP (Model Context Protocol) server for Saroday — Korean Saju (사주) calculation and myeongni-hak (命理學) glossary lookup.
This MCP server lets Claude Desktop, Cline, Cursor, and any other MCP-compatible AI client perform accurate Korean Saju (Four Pillars of Destiny) calculation by calling the public Saroday API under the hood.
When connected, the AI client gains access to four tools:
| Tool | Description |
|---|---|
calculate_saju |
Compute full Saju analysis (8 characters, sipseong, sinsal, hapchung, 12-unseong, yongshin, daeun) from birth date / time / gender. |
lookup_glossary |
Look up any of 80+ myeongni-hak terms (도화살, 천을귀인, 식신, 육합, etc.) with full Korean explanation. |
get_daily_fortune |
Today's fortune for one of 12 Western zodiac signs or 12 Chinese zodiac signs. Cached server-side, fast response. |
discover_saroday_api |
List available Saroday API endpoints and metadata. |
Why this matters: ChatGPT, Claude, and other LLMs frequently miscalculate Saju when asked directly because manse-ryeok (萬歲曆) lookup and 절기 (jeolgi) boundary handling require precise data. This MCP delegates the math to a verified server while letting the AI focus on the interpretation.
npx @saroday/mcp-server
npm install -g @saroday/mcp-server
saroday-mcp
git clone https://github.com/saroday/mcp-server.git
cd mcp-server
npm install
node index.js
Requires Node.js 18 or newer.
Edit your Claude Desktop config file:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonAdd (or merge) the following:
{
"mcpServers": {
"saroday": {
"command": "npx",
"args": ["-y", "@saroday/mcp-server"]
}
}
}
Restart Claude Desktop. You should see "saroday" listed in the MCP servers panel (the plug icon in the input area).
{
"mcpServers": {
"saroday": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/index.js"]
}
}
}
Any MCP client that supports stdio transport works. Point it at the saroday-mcp binary or node index.js. See your client's docs for the exact config format.
After connecting, ask Claude things like:
Claude will automatically invoke calculate_saju or lookup_glossary and give you a polished interpretation based on the structured data returned.
| Variable | Default | Purpose |
|---|---|---|
SARODAY_API_BASE |
https://saroday.com |
Override the API base URL (e.g., for self-hosted or staging environments). |
The public Saroday API allows 100 requests per hour per IP for free use. Heavy users — apps shipping to many end-users, AI agents handling many concurrent users — should request an API key (coming soon) for higher quotas.
Contact: [email protected]
[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
This MCP package is a thin adapter — all calculation lives on Saroday's servers, so updates to the algorithm or glossary roll out without you having to upgrade the package.
@fullstackfamily/manseryeok library)MIT
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"saroday-mcp-server": {
"command": "npx",
"args": []
}
}
}