Skip to main content
Glama
awakenorigins

lunar-mcp

lunar-mcp — Chinese lunar calendar + BaZi MCP server

An MCP server for lunar calendar operations and BaZi calculations. Solar↔lunar conversion, auspicious day guidance, 24 Solar Terms, Five Elements analysis — all accessible to any MCP-compatible agent.

OpenClaw Skill

Overview

lunar-mcp is a Model Context Protocol server that exposes Chinese lunar calendar and BaZi (Four Pillars) tools to AI agents. It handles solar-to-lunar and lunar-to-solar date conversion, generates Huang Li (auspicious day) guidance, calculates BaZi charts, tracks the 24 Solar Terms (節氣), and analyzes Five Elements composition. Based on AlbertHuangKSFO/lunar_mcp_server (MIT).

Related MCP server: timemap-mcp

Features

  • BaZi calculation — Four Pillars from birth date

  • Date conversion — solar ↔ lunar calendar

  • Huang Li — auspicious and inauspicious day guidance

  • Daily fortune — daily luck overview

  • 24 Solar Terms — 節氣 tracking

  • Five Elements — Ngũ Hành composition analysis

  • MCP protocol — works with any MCP-compatible agent

Usage / Quick Start

pip install lunar-python
# then connect via MCP protocol

Trigger Keywords (OpenClaw)

lịch âm, âm lịch, lunar calendar, hoàng lịch, tiết khí, solar terms, ngũ hành, five elements, bazi calculation, 农历, 黄历


Part of the NachaFromMars OpenClaw skill ecosystem.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides Chinese holiday information, lunar calendar conversion, traditional festivals, 24 solar terms, and BaZi (Eight Characters) calculations for AI assistants to accurately handle Chinese calendar queries and date conversions.
    3
    Apache 2.0
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI agents to perform Chinese metaphysics calculations including BaZi charts, Tong Shu indicators, solar terms, and more, using a verified engine with 740+ tests.
    8
    8
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Provides traditional Chinese astrology (Bazi, Ziwei) and divination (Liuyao, Meihua, Qimen, etc.) calculations as MCP tools for AI assistants.
    2
    18
    133 npm
    118
    Apache 2.0
  • A
    license
    A
    quality
    C
    maintenance
    Provides Chinese metaphysical tools (bazi, qimen, five elements) as MCP tools for AI agents to give personalized advice on timing, compatibility, and daily energy.
    5
    73 npm
    1
    MIT