Skip to main content
Glama
Saroday MCP Server

Saroday MCP Server

@saroday/mcp-server

MCP-сервер (Model Context Protocol) для Saroday — расчет корейского Саджу (사주) и поиск в глоссарии мённи-хак (命理學).

Этот MCP-сервер позволяет Claude Desktop, Cline, Cursor и любому другому ИИ-клиенту, совместимому с MCP, выполнять точный расчет корейского Саджу (Четыре столпа судьбы), вызывая публичный API Saroday.


Что он делает

После подключения ИИ-клиент получает доступ к четырем инструментам:

Инструмент

Описание

calculate_saju

Вычисление полного анализа Саджу (8 иероглифов, сипсон, синсаль, хапчун, 12-унсон, ёнсин, дэун) по дате/времени рождения и полу.

lookup_glossary

Поиск любого из более чем 80 терминов мённи-хак (도화살, 천을귀인, 식신, 육합 и т. д.) с полным объяснением на корейском языке.

get_daily_fortune

Гороскоп на сегодня для одного из 12 знаков западного или 12 знаков восточного зодиака. Кэшируется на стороне сервера, быстрый ответ.

discover_saroday_api

Список доступных эндпоинтов API Saroday и метаданных.

Почему это важно: ChatGPT, Claude и другие LLM часто ошибаются при расчете Саджу, если их просят напрямую, поскольку поиск по мансе-рёк (萬歲曆) и обработка границ джольги (절기) требуют точных данных. Этот MCP делегирует вычисления проверенному серверу, позволяя ИИ сосредоточиться на интерпретации.


Related MCP server: 命盘 Mingpan

Установка

Вариант А — 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. Вы должны увидеть "saroday" в списке серверов MCP (значок вилки в области ввода).

Локальная разработка (запуск из клонированного репозитория)

{
  "mcpServers": {
    "saroday": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/index.js"]
    }
  }
}

Настройка Cline / Cursor / других MCP-клиентов

Работает любой MCP-клиент, поддерживающий транспорт stdio. Укажите путь к бинарному файлу 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 и предоставит вам качественную интерпретацию на основе возвращенных структурированных данных.


Переменные окружения

Переменная

По умолчанию

Назначение

SARODAY_API_BASE

https://saroday.com

Переопределение базового URL API (например, для self-hosted или staging сред).


Ограничения скорости

Публичный API Saroday разрешает 100 запросов в час на IP для бесплатного использования. Активным пользователям — приложениям, поставляемым многим конечным пользователям, ИИ-агентам, обрабатывающим много одновременных пользователей — следует запросить 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, поэтому обновления алгоритма или глоссария внедряются без необходимости обновления пакета.


Отличительные особенности

  • Точность мансе-рёк — обрабатывает границы джольги (солнечных терминов), в которых LLM регулярно ошибаются (проверено с помощью библиотеки @fullstackfamily/manseryeok)

  • 80+ словарных статей (~400 полей интерпретации) — каждый термин синсаль, хапчун, сипсон, 12-унсон имеет краткое содержание / значение / позитивную / негативную / практическую интерпретацию, написанную на доступном корейском языке

  • Традиция корейского мённи-хак — основано на ссылках на Чокчонсу (滴天髓), Чапёнчинджон (子平真詮), Кунтонбогам (窮通寶鑑)

  • Трехканальный доступ — тот же алгоритм доступен как веб-сервис (saroday.com), публичный REST API (saroday.com/api/v1) и MCP-сервер (этот пакет). Выберите канал, который подходит для вашей интеграции.


Лицензия

MIT


Поддержка

Available Tools

4 tools
calculate_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

    A4.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables traditional Chinese metaphysics tools like Bazi, Ziwei, and Qimen via MCP, integrating AI analysis for divination and fortune-telling.
      788
      AGPL 3.0
    • A
      license
      A
      quality
      B
      maintenance
      Provides traditional Chinese astrology (Bazi, Ziwei) and divination (Liuyao, Meihua, Qimen, etc.) calculations as MCP tools for AI assistants.
      18
      299 npm
      133
      Apache 2.0
    • F
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to compute and interpret Korean Four Pillars of Destiny (Saju) through natural language, including calculation, interpretation, compatibility analysis, and daily fortune.
      4
      33 npm
      -
    • A
      license
      A
      quality
      D
      maintenance
      Provides MCP tools for Chinese metaphysics, including BaZi (Four Pillars) charting, Liu Yao hexagram casting, lunar conversion, and AI-powered destiny analysis.
      10
      18 npm
      MIT