Skip to main content
Glama
NachaFromMars

Lunar Calendar MCP Server

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: China Festival MCP Server

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
    D
    maintenance
    Enables traditional Chinese fortune-telling through BaZi (Four Pillars) analysis, including solar/lunar date conversion, Five Element balance calculations, Ten Gods deduction, and destiny interpretation for metaphysics applications.
    11 npm
    MIT
  • 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
    Not graded
    quality
    D
    maintenance
    Provides Chinese traditional calendar functions including BaZi calculation, solar-lunar calendar conversion, Huangli almanac queries, daily fortune readings, 24 solar terms, and Wu Xing (Five Elements) analysis.
    18 PyPI
    MIT
  • 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