https://github.com/baranwang/mcp-tung-shing

中国传统黄历 MCP 服务 | Chinese Traditional Almanac MCP Service
https://github.com/baranwang/mcp-tung-shing

lunar-calendar mcp mcp-server

Last synced: 28 days ago
JSON representation

中国传统黄历 MCP 服务 | Chinese Traditional Almanac MCP Service

• Host: GitHub
• URL: https://github.com/baranwang/mcp-tung-shing
• Owner: baranwang
• License: mit
• Created: 2025-01-21T12:22:17.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-04-14T00:15:45.000Z (6 months ago)
• Last Synced: 2025-04-14T01:25:31.647Z (6 months ago)
• Topics: lunar-calendar, mcp, mcp-server
• Language: TypeScript
• Homepage: https://www.npmjs.com/package/mcp-tung-shing
• Size: 250 KB
• Stars: 25
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.en.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• mcp-index - Tung Shing Almanac Service - Provides calculations for traditional Chinese almanac, including lunar calendar conversions and daily auspicious activities. Offers detailed information on Chinese metaphysics elements to assist in decision-making. (Weather and Location Data)

README

          
# Tung Shing MCP Server

[![smithery badge](https://smithery.ai/badge/@baranwang/mcp-tung-shing)](https://smithery.ai/server/@baranwang/mcp-tung-shing)

[![NPM Version](https://img.shields.io/npm/v/mcp-tung-shing.svg)](https://www.npmjs.com/package/mcp-tung-shing)

[![License](https://img.shields.io/npm/l/mcp-tung-shing.svg)](https://github.com/baranwang/mcp-tung-shing/blob/main/LICENSE)

[中文文档](./README.md) | English

> Chinese Traditional Almanac calculation service based on Model Context Protocol (MCP)

## ✨ Features

- 📅 **Calendar Conversion** - Convert between Gregorian and Chinese lunar calendar

- 🍀 **Daily Guidance** - Detailed information on recommended and avoided activities for each day

- 🕐 **Time Periods** - Fortune information for the twelve traditional Chinese time periods

- 🔮 **Metaphysical Elements** - Detailed data on five elements, deities, star constellations and other traditional metaphysical information

## 🚀 Installation & Usage

Add the following to your MCP configuration file:

```json

{

  "mcpServers": {

    "tung-shing": {

      "command": "npx",

      "args": [

        "-y",

        "mcp-tung-shing@latest"

      ]

    }

  }

}

```

## ⚙️ Tools

### get-tung-shing

Get almanac information for specified date(s)

**Parameters:**

| Parameter | Type | Required | Default | Description |

|-----------|------|----------|---------|-------------|

| `startDate` | String | No | Today | Start date, format: "YYYY-MM-DD" |

| `days` | Number | No | 1 | Number of days to retrieve |

| `includeHours` | Boolean | No | false | Whether to include hourly information |

| `tabooFilters` | Array | No | - | Filter for recommended and avoided activities, conditions are in OR relationship |

| `tabooFilters[].type` | 1 \| 2 | Yes | - | Filter type: recommends(1), avoids(2) |

| `tabooFilters[].value` | String | Yes | - | The activity to filter |

## 🤝 Contributing

Issues and Pull Requests are welcome to improve this project.