MCP Servers

sajuMCP

Calculates saju (four pillars) for a given birth year, month, day, hour, minute, and gender. Returns a compact or markdown string with the results using the ssaju engine.

README

sajuMCP

ssaju 만세력 엔진을 래핑한 stdio MCP 서버. MCP 클라이언트(Claude Desktop·Claude Code 등)가 생년월일시로 사주·만세력을 계산하도록 calculate_saju 도구를 노출한다.

엔진: ssaju (MIT · TypeScript · 의존성 0 · 원국·십성·12운성·합충형파해·신살·격국·용신·대운·세운·월운·공망 한 번에 산출)
트랜스포트: stdio (클라이언트가 서브프로세스로 실행)
라이선스: MIT

설치 / 빌드

npm install
npm run build      # tsc → dist/index.js

git 필요: 엔진 의존성 ssaju를 molpass/ssaju 포크에서 git으로 가져온다(serializeSaju 포함, 커밋 핀 고정). 따라서 npm install 시 git이 설치돼 있어야 하며, 설치 과정에서 포크를 clone해 자동 빌드한다(빌드 devDependencies를 잠시 내려받음).

MCP 클라이언트 등록

클라이언트의 MCP 서버 설정에 stdio 명령으로 추가한다.

{
  "mcpServers": {
    "saju": {
      "command": "node",
      "args": ["C:/path/to/sajuMCP/dist/index.js"]
    }
  }
}

도구: `calculate_saju`

생년월일시로 사주·만세력을 계산한다.

입력

파라미터	타입	기본값	설명
`year`	number	(필수)	연도
`month`	number	(필수)	월 1–12
`day`	number	(필수)	일 1–31
`hour`	number	12	시 0–23
`minute`	number	0	분 0–59
`gender`	`"남"` \| `"여"`	(없음)	대운 방향에 영향 → 정확한 결과 위해 제공 권장
`calendar`	`"solar"` \| `"lunar"`	`"solar"`	입력 달력 종류
`leap`	boolean	false	음력 윤달 여부
`timezone`	string	`"Asia/Seoul"`	IANA 시간대
`longitude`	number	(없음)	진태양시 보정용 경도
`applyLocalMeanTime`	boolean	(없음)	진태양시 보정 적용
`format`	`"compact"` \| `"markdown"` \| `"json"`	`"compact"`	출력 형식 (compact=LLM용 압축, markdown=사람용 상세, json=구조화 데이터)

출력

format에 따라 ssaju의 toCompact()(기본, ~950토큰) 또는 toMarkdown()(~2,170토큰) 문자열을, json이면 serializeSaju()로 직렬화한 구조화 JSON(함수 필드 제외)을 텍스트로 반환한다.

예시

입력:

{ "year": 2001, "month": 11, "day": 3, "hour": 14, "minute": 20, "gender": "남" }

출력(첫 줄):

일간 庚(경)금+  강약: 강(78)  격: 인수격  용신: 己, 丙, 癸

검증

npm test

test/smoke.test.js — 빌드된 서버에 stdio JSON-RPC 1왕복(initialize → tools/call)을 보내 위 예시 입력의 결과에 일간 庚 · 인수격 · 용신 己·丙·癸가 그대로 나오는지 확인하는 회귀 테스트.

MCP Inspector로 수동 검증:

npx @modelcontextprotocol/inspector node dist/index.js

GUI에서 calculate_saju를 위 예시 입력으로 호출하면 동일 결과를 확인할 수 있다.

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured