# BaZi True Solar Time MCP [Verified owner] [Health: Active]

**Category:** 🔮 Spirituality & Esoterica  
**Repository:** https://github.com/cdaily1995-create/true-solar-time-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/bazi-true-solar-time-mcp

## Description
Deterministic true solar time conversion for BaZi and calendrical workflows.

## Tools
Capabilities this server exposes over MCP:

- **calculate_true_solar_time** — Input:

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "bazi-true-solar-time-mcp": {
    "command": "npx",
    "args": ["-y","bazi-true-solar-time-mcp"]
  }
}
```

## Documentation

## What BaZi True Solar Time MCP does

BaZi True Solar Time MCP normalizes a local civil timestamp into corrected true solar time. It is intended for workflows where the relationship between clock time, geographic longitude, time-zone rules, daylight-saving changes, and the equation of time needs to be visible and reproducible.

The server focuses on calculation rather than interpretation. It does not create BaZi charts, generate fortune-telling text, prove astrological claims, or provide predictions. It also does not look up addresses, retain birth data, or call a language model.

## How it works

The server exposes one read-only MCP tool: `calculate_true_solar_time`. The tool takes a local date in `YYYY-MM-DD` format, a local time in `HH:mm` format, an IANA timezone identifier, and a longitude in decimal degrees. Longitude must be between -180 and 180, with east represented by positive values.

Latitude is optional and may be supplied for traceability. It is validated within -90 to 90 degrees but does not drive the correction. The calculation instead uses longitude, the applicable time-zone offset, and the equation of time.

Results identify the original civil time and corresponding UTC instant, then show the corrected local apparent solar time. The response also separates the longitude, equation-of-time, and daylight-saving corrections, reports any date rollover, and includes warnings, a confidence label, and a versioned engine identifier.

## Setup and configuration

The package can be launched directly through npm:

```bash
npx -y bazi-true-solar-time-mcp
```

For a source checkout, install dependencies, build the project, and start the generated server:

```bash
git clone https://github.com/cdaily1995-create/true-solar-time-mcp.git
cd true-solar-time-mcp
pnpm install
pnpm build
node dist/server.js
```

A stdio MCP client can start it with the following configuration:

```json
{
  "mcpServers": {
    "true-solar-time": {
      "command": "npx",
      "args": ["-y", "bazi-true-solar-time-mcp"]
    }
  }
}
```

The server requires no API key, account, database, analytics service, or external API. Coordinates and time-zone identifiers are processed by the local server process.

## Tools and capabilities

`calculate_true_solar_time` supports these inputs:

- `date`: required local civil date in `YYYY-MM-DD` format.
- `time`: required local civil time in `HH:mm` format.
- `timezone`: required IANA identifier such as `Asia/Shanghai` or `America/Los_Angeles`.
- `longitude`: required decimal degrees from -180 to 180, with east positive.
- `latitude`: optional decimal degrees from -90 to 90, retained for traceability.

The output provides the UTC instant, corrected true solar time, each correction component, date shifts, warnings, confidence, and the calculation engine version. This breakdown makes it possible to inspect how a civil timestamp was transformed instead of receiving only a normalized time.

## Limitations and notes

Accurate results depend on supplying a trusted longitude and the correct IANA timezone. The server does not infer coordinates from an address or resolve missing location data. Latitude is informational for traceability rather than a factor in the correction.

This is a time-conversion utility for calendrical, astronomy, BaZi, Four Pillars, and related workflows. It is not a prediction service or a validation of any astrological interpretation.

_Full upstream README: https://allmcps.com/mcp/bazi-true-solar-time-mcp/readme_

