Tung Shing

Provides traditional Chinese Almanac data via MCP, including calendar conversions, daily宜忌, time-branch timings, and fortune elements.

javascript

34

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run the Tong Sheng MCP service to access traditional Chinese almanac calculations via MCP. It provides calendar conversion, daily宜忌 guidance, hour-based fortunes, and classic metaphysical data, all accessible through an MCP client.

How to use

To use this MCP server, configure your MCP client to connect to the Tung Shing MCP server you run locally or remotely. You will request daily almanac data for a given date range, optionally including hourly时辰 information, and you can filter宜忌 items to tailor results to your needs.

How to install

Prerequisites: you need Node.js and npm installed on your system.

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

Configuration and usage notes

The server exposes a single MCP config that runs via npx. Use the provided command in your MCP client configuration to start or connect to the Tung Shing MCP server. No additional environment variables are shown for this server.

Tools and capabilities

get-tung-shing: Retrieve the almanac information for a specified date range. Supports optional包含时辰 (hourly) data and filtering of 宜 and 忌 items by type and value.

Available tools

get-tung-shing

Fetches almanac information for a specified date, with options to set a start date, number of days, include hourly timing data, and filter宜忌 items by type and value.