saroday-mcp-server

@saroday/mcp-server

Saroday の MCP（Model Context Protocol）サーバーです。韓国の四柱（사주）計算と、命理学（命理學）用語集の検索に対応しています。

この MCP サーバーを使うと、Claude Desktop、Cline、Cursor、その他の MCP 互換 AI クライアントから、内部で Saroday の公開 API を呼び出して、正確な韓国の四柱（運命の四つの柱）を計算できます。

---

できること

接続すると、AI クライアントから 4 つのツールを利用できます。

ツール	説明
calculate_saju	生年月日・時刻・性別から、四柱の全項目（8 文字、十星、神殺、合冲、12 運星、用神、大運）を計算します。
lookup_glossary	80 以上の命理学用語（도화살、천을귀인、식신、육합など）を、韓国語で詳しく解説します。
get_daily_fortune	12 星座のいずれか、または 12 の十二支のいずれかについて、今日の運勢を取得します。サーバー側でキャッシュされるため、応答は高速です。
discover_saroday_api	利用可能な Saroday API エンドポイントとメタデータを一覧表示します。

この機能が重要な理由：万歳暦（萬歲曆）による照合や節気（절기）の境界処理には正確なデータが必要なため、ChatGPT、Claude、その他の LLM は、直接尋ねられると四柱の計算を誤ることがよくあります。この MCP は計算を検証済みのサーバーに任せ、AI は解釈に専念できるようにします。

---

インストール

オプション 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.json
• Windows: %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 を自動的に呼び出し、返された構造化データに基づいて、洗練された解釈を提示します。

---

環境変数

変数	デフォルト値	用途
SARODAY_API_BASE	https://saroday.com	API のベース URL を変更します（セルフホスト環境やステージング環境など）。

---

レート制限

Saroday の公開 API は、無料利用の場合、IP アドレスごとに 1 時間あたり 100 件のリクエストを許可しています。多くのエンドユーザーに提供するアプリや、多数の同時ユーザーに対応する AI エージェントなど、頻繁に利用する場合は、より高い上限を利用できる API キー（近日公開予定）を申請してください。

お問い合わせ：[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

この MCP パッケージは薄いアダプターです。すべての計算は Saroday のサーバー上で行われるため、アルゴリズムや用語集が更新されても、パッケージをアップグレードする必要はありません。

---

特長

• 万歳暦の正確性 — LLM が頻繁に誤る節気（太陽の節気）の境界を適切に処理します（@fullstackfamily/manseryeok ライブラリとの照合により検証済み）。
• 80 以上の用語集項目（約 400 の解釈フィールド） — すべての神殺、合冲、十星、12 運星の用語に、親しみやすい韓国語で書かれた概要／意味／肯定的な面／否定的な面／実践的なアドバイスがあります。
• 韓国の命理学の伝統 — 『적천수（滴天髓）』『자평진전（子平真詮）』『궁통보감（窮通寶鑑）』を参考にしています。
• 3 つの提供形態 — 同じアルゴリズムを Web サービス（saroday.com）、公開 REST API（saroday.com/api/v1）、MCP サーバー（このパッケージ）として利用できます。連携方法に合った形態を選択してください。

---

ライセンス

MIT

---

Support

• Web: https://saroday.com
• API docs: https://saroday.com/api/docs
• LLM-friendly index: https://saroday.com/llms.txt
• Email: [email protected]