Saroday MCP Server
@saroday/mcp-server
用于 Saroday 的 MCP (Model Context Protocol) 服务器 — 提供韩国四柱 (사주) 计算和命理学 (命理學) 词汇查询。
此 MCP 服务器允许 Claude Desktop、Cline、Cursor 以及任何其他支持 MCP 的 AI 客户端通过调用底层的 Saroday 公共 API 来执行准确的韩国四柱(八字)计算。
功能介绍
连接后,AI 客户端将获得以下四个工具的使用权限:
工具 | 描述 |
| 根据出生日期/时间/性别计算完整的四柱分析(八字、十星、神煞、合冲、十二运星、用神、大运)。 |
| 查询 80 多个命理学术语(如 도화살、천을귀인、식신、육합等)并获取完整的韩语解释。 |
| 获取 12 个西方星座或 12 个中国生肖的每日运势。服务器端缓存,响应迅速。 |
| 列出可用的 Saroday API 端点和元数据。 |
为什么这很重要:当直接询问时,ChatGPT、Claude 和其他大语言模型经常会错误地计算四柱,因为万岁历 (萬歲曆) 查询和节气 (절기) 边界处理需要精确的数据。此 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.js需要 Node.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 询问如下问题:
"My birthday is March 15, 1992 at 10am. Calculate my Korean Saju."
"What does 도화살 (dohwa-sal) mean in Korean fortune-telling?"
"내 사주 봐줘. 1990년 5월 20일 음력 14시 여성."
"제왕(jeokwang) 12-unseong이 뭐야?"
Claude 将自动调用 calculate_saju 或 lookup_glossary,并根据返回的结构化数据为您提供精炼的解读。
环境变量
变量 | 默认值 | 用途 |
|
| 覆盖 API 基础 URL(例如,用于自托管或测试环境)。 |
速率限制
公共 Saroday API 允许免费使用,限制为 每 IP 每小时 100 次请求。重度用户(如向许多最终用户提供服务的应用程序、处理大量并发用户的 AI 代理)应申请 API 密钥(即将推出)以获得更高的配额。
联系方式:contact@saroday.com
工作原理
[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 的服务器上进行,因此算法或词汇表的更新无需您升级此包即可生效。
差异化优势
万岁历准确性 — 处理大语言模型经常出错的节气 (solar terms) 边界(已通过
@fullstackfamily/manseryeok库验证)80+ 词汇条目(约 400 个解读字段) — 每个神煞、合冲、十星、十二运星术语都有用友好的韩语编写的摘要/含义/正面/负面/实用建议解读
韩国命理学传统 — 基于《滴天髓》、《子平真诠》、《穷通宝鉴》参考资料
三通道暴露 — 同一算法可通过 Web 服务 (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