mcp-ziwei

mcp-ziwei

Calculates and returns a Ziwei Doushu (Purple Star Astrology) chart based on birth date, time, and gender. Returns both structured text of the 12 palaces and a PNG image of the chart.

Category
Visit Server

README

mcp-ziwei

생년월일·출생시각·성별을 받아 자미두수(紫微斗数) 명반을 계산해 반환하는 MCP 서버. 12궁 + 주성/보좌성 + 사화(四化) 텍스트와 12궁 명반 PNG를 돌려준다.

구조·네이밍·PNG·설치 규약은 STANDARD.md를 따른다. mcp-qr skeleton 복제본.


계산 / 렌더

  • 계산: iztro — 경량 자미두수 성반 생성 라이브러리(JS). 한국어 로케일 ko-KR 지원.
  • 렌더: @napi-rs/canvas(prebuilt) — 12궁 4×4 그리드 직접 렌더.
  • 결정론적: 같은 입력 → 같은 명반.

도구

get_ziwei

파라미터 타입 필수 기본 설명
birthDate string YYYY-MM-DD ✅ — 생년월일
birthTime string HH:MM ✅ — 출생시각 → 時辰 인덱스로 변환
gender male | female ✅ — 성별
calendarType solar | lunar solar 양/음력
lang string ko-KR 로케일

時辰 변환 (HH:MM → timeIndex 0~12): iztro util.timeToIndex 사용. 子시는 早子(00:00~00:59 → 0)·晚子(23:00~23:59 → 12)로 분리한다.

출력 (둘 다 반환):

  1. 구조화 텍스트 — 12궁(천간지지·주성·보좌성·명궁★/신궁☆) + 명주/신주/오행국 + 사화(록/권/과/기)
  2. 명반 PNG (1080×1080, 12궁 4×4 그리드, 중앙 출생정보)

예제 출력: examples/ziwei_example.png (양력 2000-08-16 03:00 寅시 · 여성).


설치

git clone https://github.com/molpass/mcp-ziwei.git
cd mcp-ziwei
npm install && npm run build

예제 명반을 직접 생성해 보려면:

npm run example   # examples/ziwei_example.png 재생성

폰트: 한글·한자 라벨을 위해 한글 가능 폰트가 필요하다. Windows는 Malgun Gothic 기본 탑재라 추가 설치 불필요. Linux는 Nanum/Noto CJK 권장.


MCP 등록 (서버명 ziwei)

{
  "mcpServers": {
    "ziwei": {
      "command": "node",
      "args": ["/abs/path/mcp-ziwei/dist/index.js"]
    }
  }
}

/abs/path는 클론한 실제 절대경로로 바꾼다. Windows 예: "args": ["C:/Users/<you>/mcp-ziwei/dist/index.js"]


스킬

페어링 스킬: skill/ziwei.skill.md.

License

MIT

Recommended Servers

playwright-mcp

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)

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.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

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.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

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

Official
Featured
Local
graphlit-mcp-server

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

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
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Exa Search

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
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured