Tung Shing MCP Server

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

简介 | Introduction

这是一个基于 Model Context Protocol (MCP) 的中国传统黄历（通胜）计算服务。它能够提供日期、时辰的吉凶、宜忌等传统历法信息。

This is a Chinese Traditional Almanac (Tung Shing) calculation service based on Model Context Protocol (MCP). It provides traditional calendar information such as auspicious/inauspicious times, suitable/unsuitable activities for specific dates and hours.

功能特点 | Features

• 支持公历转农历日期 | Support conversion between Gregorian and Lunar calendar
• 提供每日吉凶宜忌 | Daily auspicious/inauspicious activities
• 十二时辰信息 | Twelve double-hour periods information
• 五行、神煞、星宿等详细信息 | Detailed information about Five Elements, Gods, Stars, etc.

使用方法 | Usage

NPX 方式 | Using NPX

在你的 MCP 配置中添加以下内容： Add the following to your MCP configuration:

{
  "mcpServers": {
    "tung-shing": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-tung-shing"
      ]
    }
  }
}

CLI 方式 | Using CLI

全局安装包： Install the package globally:

npm install -g mcp-tung-shing

然后在 MCP 配置中添加： Then add to your MCP configuration:

{
  "mcpServers": {
    "tung-shing": {
      "command": "mcp-tung-shing"
    }
  }
}

API 参数 | API Parameters

get-tung-shing

获取指定日期的黄历信息 | Get almanac information for specified dates

• startDate: 开始日期，格式为 "YYYY-MM-DD" | Start date in "YYYY-MM-DD" format
• days: 获取天数，默认为 1 | Number of days to retrieve, defaults to 1